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