了解路由、價格與可用餘額

把公開價格視為目錄,確認帳號實際權限,並區分暫時預留積分與已結算消費。

技術核對日期:

指定路由名稱不等於取得權限

MaxAPI 有 official、official-cheap、mix、pro、x、a 等路由級別,但單一模型不一定全部提供,還取決於帳號與 API 金鑰。受限路由需要權限,填入請求並不會自動解鎖。接入前應核對模型文件與帳號可用路由,不要直接套用其他模型的路由清單。

先檢查金鑰路由設定

API 金鑰綁定的路由優先於請求指定。未綁定時,明確指定且支援的請求路由優先於模型預設。JSON 圖片請求使用 route_mode;Gemini 原生請求使用 X-MaxAPI-Route-Mode。因此只修改請求欄位,實際級別不一定改變。不要假設所選路由不可用時,就會自動切換所有其他價格級別。

使用相同計費單位比較

公開價格與 pricing.json 是目錄快照,不是帳號即時報價。登入後查看目前價格頁,確認可用路由與帳號專屬價格。每張、每次與按 token 計費不能互換,解析度、品質及適用規則也可能影響費用。MaxAPI 公開計價中 1 積分等於 1 美元;核對實際消費應使用帳務紀錄,而不是模型卡上的最低數字。

可用餘額不等於整個錢包狀態

GET /v1/account/balance 返回帳號內金鑰共用的錢包。進行中任務可能預留積分,所以結算前可用餘額就可能減少。請求逾時無法判斷是否仍有預留款,或任務是否成功。應核對最終狀態與帳務紀錄;GET /v1/account/billing/usage 僅查詢呼叫金鑰範圍的消費。即使帳號有餘額,金鑰預算或模型權限仍可能阻止請求。不要把任務預估費用當成最終結算金額。

GET https://api.maxapi.dev/v1/account/balance
Authorization: Bearer $MAXAPI_KEY

GET https://api.maxapi.dev/v1/account/billing/usage
Authorization: Bearer $MAXAPI_KEY

各模型參數

這是公開設定快照,不代表即時可用性。參數、支援路由與參考圖限制請查看各模型頁面。

參考資料

繼續接入

管理 API 金鑰API 文件查看目前價格