Open AI Image API

错误与重试

读取统一的错误响应,判断是否应该重试,并避免重复创建视频任务。

所有 API 错误都使用同一种 JSON 结构。请保存 HTTP 状态码和错误信息,联系支持时提供。

{
  "error": {
    "message": "Choose an available video model",
    "code": 400
  }
}
状态码含义是否重试
400参数、JSON、可用积分或并发任务数量不符合要求否;修正请求或等待现有任务完成
401API 密钥缺失、无效或已撤销否;更换密钥
403当前账号无法访问 API否;检查账号访问权限
404任务不存在,或属于其他账号否
413请求正文超过 2 MB否;减小请求正文
429请求过于频繁是;退避后重试
500内部错误是;等待后重试
503所选模型暂时不可用是;等待后重试

安全重试

收到 429、500 或 503 时,请使用带随机抖动的指数退避,并设置最大重试次数。轮询 GET /v1/tasks/{task_id} 可以安全重试。