错误与重试
读取统一的错误响应,判断是否应该重试,并避免重复创建视频任务。
所有 API 错误都使用同一种 JSON 结构。请保存 HTTP 状态码和错误信息,联系支持时提供。
{
"error": {
"message": "Choose an available video model",
"code": 400
}
}| 状态码 | 含义 | 是否重试 |
|---|---|---|
400 | 参数、JSON、可用积分或并发任务数量不符合要求 | 否;修正请求或等待现有任务完成 |
401 | API 密钥缺失、无效或已撤销 | 否;更换密钥 |
403 | 当前账号无法访问 API | 否;检查账号访问权限 |
404 | 任务不存在,或属于其他账号 | 否 |
413 | 请求正文超过 2 MB | 否;减小请求正文 |
429 | 请求过于频繁 | 是;退避后重试 |
500 | 内部错误 | 是;等待后重试 |
503 | 所选模型暂时不可用 | 是;等待后重试 |
安全重试
收到 429、500 或 503 时,请使用带随机抖动的指数退避,并设置最大重试次数。轮询 GET /v1/tasks/{task_id} 可以安全重试。