跳到內文
Cheapest Imagen
指南

錯誤碼

Cheapest Imagen API 回傳的全部 HTTP 狀態碼和錯誤代碼:每個代碼的含義、是否扣積分,以及出錯後該怎麼處理。

錯誤的格式和 OpenAI 相同:

{
  "error": {
    "message": "Not enough credits for this request.",
    "type": "invalid_request_error",
    "param": null,
    "code": "insufficient_credits"
  }
}

每個回應都帶有請求標頭 x-request-id。聯絡客服時請附上它。

狀態碼code含義怎麼處理
400missing_required_parameter缺少必填欄位補上 param 指出的欄位
400invalid_value某個欄位的值不被接受修改 param 指出的欄位
400unsupported_parameter這個欄位暫未開放,或目前的模型不支援(比如不支援 SVG 的模型填了 svg)去掉這個欄位,或換一個支援的模型
400model_not_found模型不存在或未開放使用 GET /v1/models 回傳的模型
400moderation_blocked提示詞或圖片被內容審核拒絕修改提示詞。不扣費;Nano Banana 穩定通道(-1k、-2k、-4k)除外
401invalid_api_key沒有金鑰或金鑰錯誤檢查 Authorization 請求標頭
402insufficient_credits積分不夠儲值
403account_suspended帳號或金鑰被停用聯絡客服
409idempotency_key_in_useIdempotency-Key 已被使用等第一個請求結束,或換一個值
413request_too_large請求或某張圖片太大縮小圖片或減少張數
429rate_limit_exceeded一分鐘內超過 300 次請求放慢後重試
429concurrency_limit_exceeded同時超過 50 個請求等其中一個完成
429moderation_paused一小時內被審核拒絕超過 10 次等一小時
502upstream_error圖片沒有生成出來重試。不扣費
504upstream_timeout生成超過 420 秒重試。不扣費

什麼時候扣費

只為你收到的圖片扣費。失敗、逾時、被審核拒絕的請求都不扣費。例外:Nano Banana 穩定通道(-1k、-2k、-4k)上游對被拒的圖照樣收費,所以被拒也扣積分。

本頁內容