ERROR CODES
错误码
共 36 个公开错误码。出错时响应体为 {"error": {"code", "message_zh", "request_id", "doc_url"}}; 「说明」一列即接口返回的 message_zh 原文,可以直接展示给你的用户。每个错误码都有锚点,例如 /docs/error-codes#INSUFFICIENT_BALANCE。
审核与授权
| 错误码 | HTTP | 说明(message_zh) | 费用 | 申诉 |
|---|---|---|---|---|
| PRE_AUDIT_CONTENT_VIOLATION | 422 | 提示词或输入素材包含违规内容,预审不通过 | 不收费预审不通过,不收钱,全额退还冻结金额 | 不适用 |
| PRE_AUDIT_FACE_AUTH_MISSING | 422 | 输入素材检测到真人肖像/声音但缺少有效本人授权备案 | 不收费真人授权预审拦截,不收钱,全额退还冻结金额 | 不适用 |
| PRE_AUDIT_INPUT_ASSET_INVALID | 422 | 输入素材无法获取或格式不符合要求,预审不通过 | 不收费输入素材无效预审拦截,不收钱,全额退还冻结金额 | 不适用 |
| POST_AUDIT_CONTENT_VIOLATION | 422 | 成片内容审核不通过,视频已拦截且不予提供下载 | 收费视频已生成,成片审核不通过照常扣费且不提供视频,支持 7 天内人工申诉 | 7 天内可申诉 |
| REAL_PERSON_AUTH_INVALID | 422 | 真人肖像/声音授权备案无效、已过期或已撤销 | 不收费真人授权校验失败,不收钱 | 不适用 |
| REAL_PERSON_AUTH_NOT_FOUND | 404 | 未找到这条真人肖像/声音授权备案:编号不存在或不属于当前企业 | 不收费没有找到授权备案,不收钱 | 不适用 |
余额与限流
| 错误码 | HTTP | 说明(message_zh) | 费用 | 申诉 |
|---|---|---|---|---|
| INSUFFICIENT_BALANCE | 402 | 账户可用余额不足以预冻结当前任务最高规格上限 | 不收费未创建生成任务,不收钱 | 不适用 |
| RATE_LIMIT_EXCEEDED | 429 | 超出 API 频率限制(默认 60 RPM) | 不收费请求被频率限制拦截,不收钱 | 不适用 |
| QUEUE_LIMIT_EXCEEDED | 429 | 超出并发排队任务上限(默认 100 个同时排队任务) | 不收费排队队列超限拦截,不收钱 | 不适用 |
鉴权与账号
| 错误码 | HTTP | 说明(message_zh) | 费用 | 申诉 |
|---|---|---|---|---|
| UNAUTHORIZED_CUSTOMER_KEY | 401 | 客户 API 密钥无效、已停用或已删除 | 不收费鉴权未通过,不收钱 | 不适用 |
| CUSTOMER_ACCOUNT_DISABLED | 403 | 客户企业账号处于暂停服务或封禁状态 | 不收费账号禁用,不收钱 | 不适用 |
| CUSTOMER_NOT_ACTIVE | 403 | 企业客户账号尚未激活或认证审核中 | 不收费账号未激活,禁止调用,不收钱 | 不适用 |
| CUSTOMER_NOT_FOUND | 404 | 指定的企业客户账号不存在 | 不收费客户不存在,不收钱 | 不适用 |
| MODEL_PERMISSION_DENIED | 403 | 当前 API 密钥未获得所请求模型包的调用授权 | 不收费无权限调用,不收钱 | 不适用 |
| API_KEY_LIMIT_EXCEEDED | 422 | 每个账号最多创建 20 把未删除的客户密钥 | 不收费密钥配额超限,不收钱 | 不适用 |
| INVALID_KYB_SUBMISSION | 400 | 企业实名认证信息不完整或未确认成片拒审扣费条款 | 不收费实名认证失败,不收钱 | 不适用 |
| CREDIT_CODE_TAKEN | 409 | 统一社会信用代码已被其他企业注册 | 不收费企业实名认证未通过,不收钱 | 不适用 |
| REQUEST_IN_PROGRESS | 409 | 同一账号有另一个请求正在处理,请稍后重试 | 不收费本次请求没有被处理,不收钱,请稍后重试 | 不适用 |
请求参数
| 错误码 | HTTP | 说明(message_zh) | 费用 | 申诉 |
|---|---|---|---|---|
| INVALID_PARAMETER | 400 | 请求参数不合法:请求内容不是合法的 JSON,或某个字段的取值不在允许范围内,请对照接口文档检查 | 不收费参数校验失败,不收钱 | 不适用 |
| INVALID_FRAME_LENGTH | 400 | 请求帧数不符合 length % 17 == 5 步进规范或超出合法区间 [22, 362] | 不收费参数校验失败,不收钱 | 不适用 |
| INVALID_RESOLUTION | 400 | 不支持的分辨率规格,仅支持 1376x768 与 864x480 | 不收费参数校验失败,不收钱 | 不适用 |
| METHOD_NOT_ALLOWED | 405 | 当前接口不支持该 HTTP 请求方法 | 不收费请求方法不支持,不收钱 | 不适用 |
| NOT_FOUND | 404 | 接口不存在,请对照接口文档检查请求路径 | 不收费接口不存在,不收钱 | 不适用 |
任务与下载
| 错误码 | HTTP | 说明(message_zh) | 费用 | 申诉 |
|---|---|---|---|---|
| TASK_NOT_FOUND | 404 | 未查询到指定的视频生成任务 | 不收费任务不存在,不收钱 | 不适用 |
| TASK_NOT_CANCELLABLE | 409 | 任务已处于运行中或已进入终态,无法取消 | 不收费取消操作无效,依任务实际终态计费规则结算 | 不适用 |
| TASK_ALREADY_RUNNING | 409 | 任务已进入运行中状态,无法取消 | 不收费任务已开始生成,取消无效,按最终结果结算 | 不适用 |
| TASK_RETENTION_EXPIRED | 404 | 任务已超过 30 天的查询期,不再提供查询和成片下载 | 不收费任务已超过查询期,不收钱 | 不适用 |
| DOWNLOAD_URL_EXPIRED | 410 | 视频下载签名链接已过期(有效期 24 小时),请通过任务查询接口获取新链接 | 不收费链接有效期内刷新不收取任何额外费用(任务留存期 30 天) | 不适用 |
| INTERNAL_GENERATION_FAILED | 500 | 底层视频生成执行失败,系统已自动全额退还冻结金额 | 不收费执行失败,不收钱,系统已自动全额退冻 | 不适用 |
| EXTERNAL_ID_CONFLICT | 409 | 该 external_id 已经用过:这次请求的参数和上次不同,或上次的订单已失败并退款。请换一个新的 external_id;想取回上次的任务,请用和上次完全相同的参数重试(上次已失败退款的除外) | 不收费没有创建新的生成任务,不收钱 | 不适用 |
申诉
| 错误码 | HTTP | 说明(message_zh) | 费用 | 申诉 |
|---|---|---|---|---|
| APPEAL_NOT_ELIGIBLE | 422 | 仅「成片审核不通过(已扣费)」任务支持发起人工复核申诉;输入预审不通过或未扣费任务无需且不支持申诉 | 不收费任务不具备申诉资格,原状态与计费维持不变 | 不适用 |
| APPEAL_WINDOW_EXPIRED | 422 | 已超过成片审核结束 7 天(168 小时)申诉有效期,无法提交申诉 | 不收费申诉已过期,原计费维持不变 | 不适用 |
| APPEAL_ALREADY_SUBMITTED | 409 | 该任务已提交过人工复核申诉,请勿重复提交 | 不收费申诉处理中或已裁决,请勿重复提交 | 不适用 |
服务状态
| 错误码 | HTTP | 说明(message_zh) | 费用 | 申诉 |
|---|---|---|---|---|
| SERVICE_UNAVAILABLE | 503 | 服务暂时不可用,请稍后重试 | 不收费本次请求未能处理,不收钱,请稍后重试 | 不适用 |
| OUTCOME_UNKNOWN | 500 | 请求的处理结果不确定,请先查询确认,再决定是否重试 | 结果不确定结果不确定,是否扣费以查询到的订单和账单为准,请先查询再决定是否重试 | 不适用 |
| INTERNAL_ERROR | 500 | 系统内部异常,请稍后重试;一直出现请带上 request_id 联系我们 | 不收费本次请求没有完成,不收钱;已经提交的任务照常按它自己的结果计费 | 不适用 |