错误码
每个 error.code 的含义、状态码和出现的接口。
错误响应都带 error.code 和 trace_id。按 error.code 处理，联系我们时附上 trace_id。重试规则见「幂等与重试」。
| 状态码 | error.code | 含义 | 怎么处理 | 能否原样重试 | 是否收费 |
|---|---|---|---|---|---|
| 400 404 | asset_not_found | 素材不存在、已删除或不属于本团队查询素材状态、创建视频任务 | 检查素材 ID 是否属于本团队且未删除。 | 不可以 | 不收费 |
| 400 | asset_unusable | 素材失败、媒体类型不适用或审核不适用于当前请求创建视频任务 | 换一个可用的素材，或让素材类型与用途一致。 | 不可以 | 不收费 |
| 400 | callback_target_not_verified | 请求地址与本团队已验证、未撤销且未过期的回调目标地址不逐字节相同创建视频任务 | 在控制台登记并验证这个回调地址，或去掉 callback_url。 | 不可以 | 不收费 |
| 400 | input_video_duration_exceeded | 输入视频总时长超过模型限制创建视频任务 | 缩短参考视频，使总时长不超过模型上限。 | 不可以 | 不收费 |
| 400 | invalid_request | 请求无效，包含超过模型参考数量的情况登记素材、查询素材状态、创建视频任务、列出团队任务、查询视频任务、取消视频任务、查询单任务账单 | 按 error.message 修正请求后再发送。 | 不可以 | 不收费 |
| 400 | source_url_not_allowed | 来源地址不符合获取策略登记素材 | 换一个符合要求的公开 HTTPS 地址。 | 不可以 | 不收费 |
| 400 | unsupported_capability | 可用选项无法同时满足所需能力创建视频任务 | 按 error.details 里的参数调整请求。 | 不可以 | 不收费 |
| 401 | authentication_failed | 认证失败登记素材、查询素材状态、创建视频任务、列出团队任务、查询视频任务、取消视频任务、查询单任务账单 | 检查 Authorization: Bearer 后面的 API 密钥。 | 不可以 | 不收费 |
| 403 | permission_denied | 缺少所需权限登记素材、查询素材状态 | 换一把有 service.use 权限的 API 密钥。 | 不可以 | 不收费 |
| 404 | task_not_found | 任务不存在或对本团队不可见查询视频任务、取消视频任务、查询单任务账单 | 检查任务 ID 是否属于本团队。 | 不可以 | 不收费 |
| 409 | asset_not_ready | 引用素材仍在处理中创建视频任务 | 等素材变为 active 后，用同一个键原样重试。 | 条件满足后可以 | 不收费 |
| 409 | idempotency_conflict | 同一个幂等键用于不同请求登记素材、创建视频任务、取消视频任务 | 用原请求体重试同一个键；新请求换一个新键。 | 不可以 | 不收费 |
| 409 410 | idempotency_replay_expired | 精确重放响应已过期登记素材、创建视频任务、取消视频任务 | 原请求已被接受，按 ID 查询它，不要换键重发。 | 不可以 | 不收费 |
| 409 | key_provisioning_incomplete | 该 API Key 的额度配置未完成，需删除后新建创建视频任务 | 删除这把 API 密钥，再新建一把。 | 不可以 | 不收费 |
| 409 | task_not_cancellable | 终态任务没有可引用的取消操作取消视频任务 | 任务已结束，无需取消。 | 不可以 | 不收费 |
| 429 | asset_intake_rate_limit_exceeded | 素材接入容量受限登记素材 | 稍后用同一个键重试。 | 条件满足后可以 | 不收费 |
| 429 | asset_storage_quota_exceeded | 素材存储额度不足登记素材、创建视频任务 | 存储额度不足，清理素材或联系我们后再登记。 | 不可以 | 不收费 |
| 429 | insufficient_balance | 余额不足以接受请求创建视频任务 | 充值后用同一个键重试；error.details 给出所需的预留金额。 | 条件满足后可以 | 不收费 |
| 429 | rate_limited | 请求频率受限创建视频任务、列出团队任务、查询视频任务、取消视频任务、查询单任务账单 | 等 Retry-After 秒后用同一个键重试。 | 条件满足后可以 | 不收费 |
| 500 | internal_error | 服务未能完成请求创建视频任务、列出团队任务、查询视频任务、取消视频任务、查询单任务账单 | 用同一个 Idempotency-Key 原样重试。 | 可以，用同一个键 | 不收费；重试不会重复收费 |
| 503 | dependency_unavailable | 服务暂时不可用，结果不确定登记素材、查询素材状态、创建视频任务、列出团队任务、查询视频任务、取消视频任务、查询单任务账单 | 结果不确定，用同一个键原样重试。 | 可以，用同一个键 | 不收费；重试不会重复收费 |
| 503 | funding_intake_closed | 新接入已关闭创建视频任务 | 暂不接受新任务，稍后再试；已接受请求的原样重放仍返回原响应。 | 条件满足后可以 | 不收费 |
没有匹配的错误码。