GPT Image 2 已在 MaxAPI 上線
max
文件價格
語言
繁中

MaxAPI 文件

開發者指南：Python、Node.js、非同步任務與錯誤處理

MaxAPI 透過一致的 API 端點提供圖片、影片與語言模型，使用 Authorization 標頭中的 Bearer token 進行認證。 1 積分 = 1 美元. 失敗的請求不會收費。每個公開模型提供一個或多個 route_mode 層級，依請求改變定價。

Base URL 一覽

三個主機提供完全相同的 API、Bearer 金鑰與端點，差別只在預設行為：

  • https://api.maxapi.dev — 預設的 Base URL。
  • https://native.maxapi.dev — 以供應商原生格式（base64 / inlineData）內嵌回傳影像位元組，而非 MaxAPI 託管的 URL；與 Gemini 的 :generateContent 回傳格式一致。
  • https://async.maxapi.dev — 生成請求預設走非同步（回傳可輪詢的 task id），不需要再傳 async:true。

端點家族

  • OpenAI 相容: GET /v1/models, POST /v1/images/generations, POST /v1/images/edits, POST /v1/videos/generations, GET /v1/images/generations/{task_id}, GET /v1/videos/generations/{task_id}.
  • Gemini 原生（語言與圖片）: POST /v1beta/models/{model}:generateContent, GET /v1beta/models, GET /v1beta/models/{model}, GET /v1beta/operations/{task_id}.
  • OpenAI 文字 / 嵌入: /v1/chat/completions, /v1/responses, /v1/embeddings (中繼提供；預設不含公開模型種子).
  • 帳戶: GET /v1/account/balance, GET /v1/account/billing/usage, GET /api/usage/token, GET /v1/usage. 餘額相容端點支援 OpenAI 風格工具、new-api 與 sub2api。

認證

在每個請求送出 Authorization: Bearer $MAXAPI_KEY 。Gemini 原生端點另外也接受 x-goog-api-key 以及 ?key=.

OpenAI 模型查詢

使用 OpenAI 相容的 models API，列出此 API 金鑰可用的所有模型。回應同時包含帶供應商前綴的標準 ID，以及可明確解析的短別名。

curl -s "https://api.maxapi.dev/v1/models" \
  -H "Authorization: Bearer $MAXAPI_KEY"

回應使用 OpenAI 的清單格式：object 為 list，data 包含具有 id、object 與 owned_by 的模型物件。目前此端點不提供 OpenAI 格式的單一模型查詢。

Gemini 模型查詢

使用 Google 官方 models API 格式，列出此 API 金鑰可用的 Gemini 原生模型。相同端點可在所有 MaxAPI Base URL 使用；Gemini SDK 建議使用 native.maxapi.dev。

# List available Gemini models
curl -s "https://native.maxapi.dev/v1beta/models?pageSize=50" \
  -H "x-goog-api-key: $MAXAPI_KEY"

# Get one model
curl -s "https://native.maxapi.dev/v1beta/models/gemini-2.5-flash" \
  -H "x-goog-api-key: $MAXAPI_KEY"
  • GET /v1beta/models — 列出可用的 Gemini 模型。pageSize 預設為 50、上限為 1000；若要繼續查詢，請將 nextPageToken 作為 pageToken 傳回。
  • GET /v1beta/models/{model} — 回傳單一模型的中繼資料。請使用 models/ 後方回傳的短 ID。

回應使用 Google 的 Model 與 ListModelsResponse 欄位名稱，包括 name、baseModelId、version、displayName、Token 上限、supportedGenerationMethods 與 nextPageToken。

MaxAPI 結構化模型目錄

當你需要文件與產品中繼資料，而不是 SDK 相容回應時，請使用 MaxAPI 的公開 JSON 目錄。

curl -s "https://www.maxapi.dev/models.json"

不需要 API 金鑰。此目錄包含 public_model_id、display_name、kind、route_modes、文件連結、支援選項、圖片與價格摘要。它是公開文件目錄，不會依特定 API 金鑰篩選；請使用 /v1/models 或 /v1beta/models 查詢該金鑰可用的模型。

常用請求參數

  • route_mode: official | official-cheap | mix | pro | x | a. 放在 JSON 主體中，或作為 X-MaxAPI-Route-Mode （用於 Gemini 原生）。

    這些是可辨識的路由值，不代表每個模型都支援全部路由。實際可用性取決於模型、已啟用路由及帳戶。pro、x、a 需要帳戶權限；未獲授權卻指定這些路由時會回傳 403。

    路由優先順序：若 API 金鑰已設定 route_modes 清單，該清單優先於請求中的指定。若未設定，則使用請求明確指定的路由；兩者皆未設定時，使用模型預設路由。比較路由價格前，請先確認 API 金鑰設定。

  • asset_delivery: default 或 mirror. mirror 會把回傳的 URL 改寫為別名 CDN 網域。
  • async: true 會將請求排入佇列並回傳 task id；輪詢回傳的 poll_url 以取得完成結果。

帳戶餘額

GET /v1/account/balance 會回傳金鑰擁有者的錢包餘額。 available 是目前可用的餘額， frozen_micro_credits 是被進行中的非同步任務凍結的，且 1 積分 = 1 美元. 使用相同的 bearer 金鑰，於所有 base URL 皆可用。

請使用您要查詢其帳戶餘額的 API 金鑰進行驗證。

curl -s https://native.maxapi.dev/v1/account/balance \
  -H "Authorization: Bearer $MAXAPI_KEY"

# {
#   "object": "credit_balance",
#   "available": 34.25608,
#   "available_micro_credits": 34256080,
#   "frozen_micro_credits": 0,
#   "total_micro_credits": 34256080,
#   "available_usd": 34.25608,
#   "usd_per_credit": 1,
#   "status": "active"
# }
  • available: 目前可使用的積分。
  • frozen_micro_credits: 由執行中的非同步任務預留的積分。
  • total_micro_credits: 可用積分與預留積分的總和。
  • available_usd: 以美元顯示的可用餘額。
  • status: 錢包狀態。

同一帳戶下的多個 API 金鑰共用一個錢包，因此會回傳相同餘額。 此端點回報帳戶的即時餘額。歷史消費請使用下方依 API 金鑰區分的帳單端點。

OpenAI 風格的餘額工具可直接從以下讀取： GET /dashboard/billing/subscription (餘額位於 hard_limit_usd) 以及 GET /dashboard/billing/usage. usage 相容端點不會回傳依 API 金鑰區分的歷史用量。

new-api 餘額相容

GET /api/usage/token 實作 QuantumNous/new-api 使用的 API 金鑰額度回應。請使用要查詢的 API 金鑰認證；每把金鑰只能查詢自身資料。

curl -s https://native.maxapi.dev/api/usage/token \
  -H "Authorization: Bearer $MAXAPI_KEY"

# {
#   "code": true,
#   "message": "ok",
#   "data": {
#     "object": "token_usage",
#     "name": "Production",
#     "total_granted": 50000000,
#     "total_used": 12500000,
#     "total_available": 37500000,
#     "unlimited_quota": false,
#     "model_limits": {"gpt-image-2": true},
#     "model_limits_enabled": true,
#     "expires_at": 0
#   }
# }

quota 欄位使用 new-api 的預設整數單位：500,000 quota 等於 1 美元。total_used 是此金鑰在目前 UTC 月已結算的用量；total_available 是共享可用錢包與此金鑰月度剩餘額度中的較小值。

sub2api 餘額相容

GET /v1/usage 實作 Wei-Shaw/sub2api 使用的 API 金鑰餘額回應。接受 Authorization: Bearer、x-api-key 或 x-goog-api-key；不接受查詢字串中的 API 金鑰。

curl -s https://native.maxapi.dev/v1/usage \
  -H "x-api-key: $MAXAPI_KEY"

# {
#   "mode": "quota_limited",
#   "isValid": true,
#   "status": "active",
#   "remaining": 75,
#   "unit": "USD",
#   "balance": 80,
#   "quota": {
#     "limit": 100,
#     "used": 25,
#     "remaining": 75,
#     "unit": "USD"
#   }
# }

數值單位為美元。balance 是共享錢包金額；remaining 是同時套用錢包與月度上限後，此金鑰實際可使用的金額。沒有月度上限的金鑰會回傳 unrestricted 模式並省略 quota。

依 API 金鑰查詢帳單用量

GET /v1/account/billing/usage 回傳共用錢包的目前餘額，以及僅限本次 Bearer API 金鑰的歷史用量。 呼叫者無法指定或檢視其他金鑰。

curl -s "https://native.maxapi.dev/v1/account/billing/usage?from=2026-08-01T00%3A00%3A00Z&to=2026-09-01T00%3A00%3A00Z&limit=100" \
  -H "Authorization: Bearer $MAXAPI_KEY"

預設回傳目前 UTC 月初至今的資料。可使用 RFC3339 格式的 from（包含）與 to（不包含）、limit（1–500），以及回傳的 cursor 查詢較舊明細。

summary 與模型彙總涵蓋整個查詢期間，data 則包含一頁請求明細。費用是套用該金鑰價格倍率後的最終結算金額。

同一帳戶的所有金鑰共用 balance。monthly_quota 表示此金鑰在目前 UTC 月份的額度上限、已用量與剩餘額度；無上限金鑰的 limit 與 remaining 回傳 null。

各模型 API 參考

機器可讀索引