指南
错误码
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)上游对被拒的图照样收费,所以被拒也扣积分。