错误与重试

出错时返回非 2xx 状态码和 error 对象。

错误格式

响应

{
  "error": {
    "message": "Duration must be between 4 and 15 seconds, or -1",
    "type": "invalid_request_error",
    "code": null
  }
}

HTTP	type	说明与处理
400	invalid_request_error	参数缺失或越界，如分辨率不支持、时长超出范围、素材数量超限
401	—	API 密钥缺失、错误或已禁用
403	—	密钥无权使用该模型或分组
404	invalid_request_error	任务不存在，或不属于当前密钥
429	—	请求过于频繁或并发已满，稍后重试
500 / 502 / 503	server_error	上游或网关暂时异常。任务接口请先查询任务，确认未创建后再重试

400、401、403 不要重试，先修正请求或密钥。429 和 5xx 可按 1、2、4 秒退避重试。异步任务提交超时时，先查询调用记录或任务列表，确认没有创建任务后再重新提交，避免重复扣费。