# 错误码

每个 error.code 的含义、状态码和出现的接口。

| 状态码 | 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` | 新接入已关闭（出现于创建视频任务） | 暂不接受新任务，稍后再试；已接受请求的原样重放仍返回原响应。 | 条件满足后可以 | 不收费 |