错误与重试

错误格式

{
  "error": {
    "code": "invalid_parameters",
    "message": "Unsupported resolution."
  }
}

错误使用 application/json 和相应 HTTP 状态。根据 error.code 判断，不依赖提示文案。

视频和图片创建请求必须携带 Idempotency-Key，长度 16–128，只包含字母、数字、下划线或连字符。将其随业务操作持久保存。同标识和请求体重放原任务，不重复扣费；参数变化返回 409 idempotency_conflict。重试和查询必须使用原 API 密钥。

HTTP	Code	处理
401	`invalid_api_key`	检查或更新密钥。
403	`api_key_upgrade_required`	创建新密钥。
403	`server_side_only`	改为服务端调用。
403	`paid_account_required`	需要有效付费订阅或购买积分。
404	`generation_not_found`	检查 ID 和原密钥。
409	`idempotency_conflict`	恢复原请求体。
409	`cost_limit_exceeded`	核对报价和最高扣费限制。
413	`request_too_large`	减少请求体大小。
422	`invalid_parameters`	根据模型目录修正参数。
429	`rate_limit_exceeded / concurrency_limit_exceeded / daily_spend_limit_exceeded`	遵循 Retry-After 和账户限额。
503	`api_unavailable / service_unavailable`	退避后重试原请求。

网络错误、429 和 503 使用退避策略，保留原请求标识。409 generation_rejected 明确表示提交前被拒绝，解决原因后才创建新请求。结果未知的超时不能自动变成新生成。边缘防火墙每 IP 每分钟 120 次，超限可能返回非 JSON 的 403，请等待窗口重置。