错误码

API 使用标准 HTTP 状态码，错误响应体格式如下：

{
  "error": {
    "message": "错误描述",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

常见错误对照表

HTTP 状态码	常见原因	排查方法
400	请求参数错误（缺少必填字段、参数值不合法、模型不支持该分辨率等）	对照文档检查请求体字段与取值
401	API Key 无效、格式错误或已删除	检查 Authorization: Bearer <key> 格式，到控制台确认 Key 状态
403	余额不足、Key 额度用尽或无该模型权限	到控制台查看余额与 Key 配置
404	请求路径错误，或查询的任务 ID 不存在	检查 URL 拼写；确认任务 ID 来自创建接口的返回
429	请求频率超限	降低请求频率，稍后重试；如需更高配额请联系我们
500 / 503	服务内部错误或上游模型服务暂时不可用	稍后重试；持续出现请联系技术支持

视频任务相关

视频生成为异步任务，任务本身的失败通过查询接口的 status 与 error 字段返回：

任务状态	说明
queued / in_progress	排队中 / 生成中，请继续轮询
completed	生成成功，结果地址在返回体中
failed	生成失败，error.message 为失败原因，失败任务不扣费（已扣部分自动退回）

轮询建议

建议每 5~10 秒查询一次任务状态。生成通常在几十秒到几分钟内完成，与视频时长和分辨率有关。

获取帮助

如遇无法解决的问题，请记录下完整的请求（去除 API Key）、响应体和发生时间，联系技术支持：控制台内联系管理员