API 文档

错误处理 / 频次限制

错误处理

发生 HTTP 错误时将返回一个包含 code 和 message 的 error 对象。成功创建的任务仍有可能在后续处理中失败，请及时查询任务状态或处理失败回调。

{
  "error": {
    "code": "invalid_request",
    "message": "input.prompt is required."
  }
}

HTTP	字段	解决方法
400	`invalid_request`	请求参数有误，请在重试前修正 JSON 格式、缺失的提示词、参数取值范围或媒体文件 URL。
401	`invalid_api_key`	身份验证失败，请检查您的 Bearer 令牌及 API 密钥是否处于启用状态。
402	`insufficient_credits`	账户余额不足。请充值或降低本次任务的生成配置。响应中可能会返回当前任务所需积分及您的可用积分。
403	`forbidden`	请检查错误信息中提示的账户限制。
404	`not_found`	未找到相关资源。请检查任务 ID 是否正确，以及该密钥是否属于发起该任务的用户。
429	`rate_limited`	请求过于频繁，请在 Retry-After 指定的时间间隔后再进行重试。
500	`internal_error`	服务器内部错误。请查看错误消息和 API 日志。重试时请保持谨慎；重新发送创建请求可能会创建新的计费任务。

创建任务：每个 API 密钥默认每分钟最多请求 100 次，目前不支持自定义设置限额。

查询任务：每个 API 密钥默认每分钟最多请求 120 次。查询任务与创建任务分别计数，互不占用对方的请求额度。

图片与视频的创建请求共享同一个 API Key 的限流额度。

触发 HTTP 429 限流时，创建接口响应头会包含 Retry-After: 60，查询接口会包含 Retry-After: 5。请在代码中加入退避重试逻辑，避免高频轮询。

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Retry-After: 60

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded."
  }
}