跳到正文
通达云视频

ERROR CODES

错误码

共 36 个公开错误码。出错时响应体为 {"error": {"code", "message_zh", "request_id", "doc_url"}}; 「说明」一列即接口返回的 message_zh 原文,可以直接展示给你的用户。每个错误码都有锚点,例如 /docs/error-codes#INSUFFICIENT_BALANCE。

审核与授权

错误码HTTP说明(message_zh)费用申诉
PRE_AUDIT_CONTENT_VIOLATION422提示词或输入素材包含违规内容,预审不通过
不收费预审不通过,不收钱,全额退还冻结金额
不适用
PRE_AUDIT_FACE_AUTH_MISSING422输入素材检测到真人肖像/声音但缺少有效本人授权备案
不收费真人授权预审拦截,不收钱,全额退还冻结金额
不适用
PRE_AUDIT_INPUT_ASSET_INVALID422输入素材无法获取或格式不符合要求,预审不通过
不收费输入素材无效预审拦截,不收钱,全额退还冻结金额
不适用
POST_AUDIT_CONTENT_VIOLATION422成片内容审核不通过,视频已拦截且不予提供下载
收费视频已生成,成片审核不通过照常扣费且不提供视频,支持 7 天内人工申诉
7 天内可申诉
REAL_PERSON_AUTH_INVALID422真人肖像/声音授权备案无效、已过期或已撤销
不收费真人授权校验失败,不收钱
不适用
REAL_PERSON_AUTH_NOT_FOUND404未找到这条真人肖像/声音授权备案:编号不存在或不属于当前企业
不收费没有找到授权备案,不收钱
不适用

余额与限流

错误码HTTP说明(message_zh)费用申诉
INSUFFICIENT_BALANCE402账户可用余额不足以预冻结当前任务最高规格上限
不收费未创建生成任务,不收钱
不适用
RATE_LIMIT_EXCEEDED429超出 API 频率限制(默认 60 RPM)
不收费请求被频率限制拦截,不收钱
不适用
QUEUE_LIMIT_EXCEEDED429超出并发排队任务上限(默认 100 个同时排队任务)
不收费排队队列超限拦截,不收钱
不适用

鉴权与账号

错误码HTTP说明(message_zh)费用申诉
UNAUTHORIZED_CUSTOMER_KEY401客户 API 密钥无效、已停用或已删除
不收费鉴权未通过,不收钱
不适用
CUSTOMER_ACCOUNT_DISABLED403客户企业账号处于暂停服务或封禁状态
不收费账号禁用,不收钱
不适用
CUSTOMER_NOT_ACTIVE403企业客户账号尚未激活或认证审核中
不收费账号未激活,禁止调用,不收钱
不适用
CUSTOMER_NOT_FOUND404指定的企业客户账号不存在
不收费客户不存在,不收钱
不适用
MODEL_PERMISSION_DENIED403当前 API 密钥未获得所请求模型包的调用授权
不收费无权限调用,不收钱
不适用
API_KEY_LIMIT_EXCEEDED422每个账号最多创建 20 把未删除的客户密钥
不收费密钥配额超限,不收钱
不适用
INVALID_KYB_SUBMISSION400企业实名认证信息不完整或未确认成片拒审扣费条款
不收费实名认证失败,不收钱
不适用
CREDIT_CODE_TAKEN409统一社会信用代码已被其他企业注册
不收费企业实名认证未通过,不收钱
不适用
REQUEST_IN_PROGRESS409同一账号有另一个请求正在处理,请稍后重试
不收费本次请求没有被处理,不收钱,请稍后重试
不适用

请求参数

错误码HTTP说明(message_zh)费用申诉
INVALID_PARAMETER400请求参数不合法:请求内容不是合法的 JSON,或某个字段的取值不在允许范围内,请对照接口文档检查
不收费参数校验失败,不收钱
不适用
INVALID_FRAME_LENGTH400请求帧数不符合 length % 17 == 5 步进规范或超出合法区间 [22, 362]
不收费参数校验失败,不收钱
不适用
INVALID_RESOLUTION400不支持的分辨率规格,仅支持 1376x768 与 864x480
不收费参数校验失败,不收钱
不适用
METHOD_NOT_ALLOWED405当前接口不支持该 HTTP 请求方法
不收费请求方法不支持,不收钱
不适用
NOT_FOUND404接口不存在,请对照接口文档检查请求路径
不收费接口不存在,不收钱
不适用

任务与下载

错误码HTTP说明(message_zh)费用申诉
TASK_NOT_FOUND404未查询到指定的视频生成任务
不收费任务不存在,不收钱
不适用
TASK_NOT_CANCELLABLE409任务已处于运行中或已进入终态,无法取消
不收费取消操作无效,依任务实际终态计费规则结算
不适用
TASK_ALREADY_RUNNING409任务已进入运行中状态,无法取消
不收费任务已开始生成,取消无效,按最终结果结算
不适用
TASK_RETENTION_EXPIRED404任务已超过 30 天的查询期,不再提供查询和成片下载
不收费任务已超过查询期,不收钱
不适用
DOWNLOAD_URL_EXPIRED410视频下载签名链接已过期(有效期 24 小时),请通过任务查询接口获取新链接
不收费链接有效期内刷新不收取任何额外费用(任务留存期 30 天)
不适用
INTERNAL_GENERATION_FAILED500底层视频生成执行失败,系统已自动全额退还冻结金额
不收费执行失败,不收钱,系统已自动全额退冻
不适用
EXTERNAL_ID_CONFLICT409该 external_id 已经用过:这次请求的参数和上次不同,或上次的订单已失败并退款。请换一个新的 external_id;想取回上次的任务,请用和上次完全相同的参数重试(上次已失败退款的除外)
不收费没有创建新的生成任务,不收钱
不适用

申诉

错误码HTTP说明(message_zh)费用申诉
APPEAL_NOT_ELIGIBLE422仅「成片审核不通过(已扣费)」任务支持发起人工复核申诉;输入预审不通过或未扣费任务无需且不支持申诉
不收费任务不具备申诉资格,原状态与计费维持不变
不适用
APPEAL_WINDOW_EXPIRED422已超过成片审核结束 7 天(168 小时)申诉有效期,无法提交申诉
不收费申诉已过期,原计费维持不变
不适用
APPEAL_ALREADY_SUBMITTED409该任务已提交过人工复核申诉,请勿重复提交
不收费申诉处理中或已裁决,请勿重复提交
不适用

服务状态

错误码HTTP说明(message_zh)费用申诉
SERVICE_UNAVAILABLE503服务暂时不可用,请稍后重试
不收费本次请求未能处理,不收钱,请稍后重试
不适用
OUTCOME_UNKNOWN500请求的处理结果不确定,请先查询确认,再决定是否重试
结果不确定结果不确定,是否扣费以查询到的订单和账单为准,请先查询再决定是否重试
不适用
INTERNAL_ERROR500系统内部异常,请稍后重试;一直出现请带上 request_id 联系我们
不收费本次请求没有完成,不收钱;已经提交的任务照常按它自己的结果计费
不适用