错误与限制
每次失败都使用同一个信封。代码是稳定的;消息是英文回退内容,可以展示给用户。
响应
{
"error": {
"code": "insufficient_credits",
"message": "You need more credits to generate."
}
}状态
| HTTP | 典型代码 | 该怎么办 |
|---|---|---|
| 400 | invalid_request, prompt_too_long, invalid_reference_image | 修复请求;不要原样重试 |
| 401 | unauthorized | 检查密钥;不要循环重试 |
| 402 | insufficient_credits | 充值积分;切勿重试 |
| 403 | unauthorized | 未付费创建密钥,或未开通高级版却请求音频 |
| 404 | not_found | 未知任务,或不属于此账户 |
| 409 | invalid_request | Idempotency-Key 冲突;请使用新的密钥 |
| 413 / 415 | invalid_request / unsupported_image_type | 上传较小的 JPEG、PNG 或 WebP 文件 |
| 429 | rate_limited | 等待 Retry-After |
| 500 / 503 | internal | 使用退避策略重试 |
400
- 典型代码
invalid_request,prompt_too_long,invalid_reference_image- 该怎么办
- 修复请求;不要原样重试
401
- 典型代码
unauthorized- 该怎么办
- 检查密钥;不要循环重试
402
- 典型代码
insufficient_credits- 该怎么办
- 充值积分;切勿重试
403
- 典型代码
unauthorized- 该怎么办
- 未付费创建密钥,或未开通高级版却请求音频
404
- 典型代码
not_found- 该怎么办
- 未知任务,或不属于此账户
409
- 典型代码
invalid_request- 该怎么办
Idempotency-Key冲突;请使用新的密钥
413 / 415
- 典型代码
invalid_request/unsupported_image_type- 该怎么办
- 上传较小的 JPEG、PNG 或 WebP 文件
429
- 典型代码
rate_limited- 该怎么办
- 等待
Retry-After
500 / 503
- 典型代码
internal- 该怎么办
- 使用退避策略重试
一次失败的生成是一个 200 作业响应,带有 status: "failed" 和一个代码为 internal 的 error 对象。已完成的作业即终态:请勿重新提交。
重试策略
- 仅重试 HTTP
429、timeout和internal响应。 - 永远不要重试
insufficient_credits,也永远不要重新提交已经以failed结束的任务。 - 在创建操作中使用
Idempotency-Key,这样重试就不会重复扣费。 - 以指数方式退避,并加入抖动,起始时间约为一秒。
速率限制
限额按密钥计算,采用固定的一分钟窗口,除非另有说明。默认值:
- 每分钟60个请求(整体)。
- 每分钟可生成10次。
- 每分钟 5 次上传。
- 120
GET /v1/models请求/分钟 每个客户端 IP(该路由是公开的)。 - 每个账户每小时可创建5次API密钥。
429 携带 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset 和 Retry-After。
可用性
如果 /v1 暂时不可用,每个路由都会返回 503,代码为 internal。请稍后以退避策略重试。