本文档说明通过本平台调用第三方模型（PixVerse / Kling（可灵）/ Vidu / MiniMax）时，模型厂商侧错误码的响应形态、取值与排查方法。
各模型厂商错误字段位置
不同模型厂商的错误字段命名、位置、值类型均不同，必须先定位再解析。
厂商 | 错误码字段 | 错误描述字段 | 成功值 | 失败判据 | 响应形态 |
PixVerse | ErrCode（number） | ErrMsg | 0 | 非 0 | {ErrCode, ErrMsg, Resp} |
Kling | code（number） | message | 0 | 非 0 | {code, message, request_id, data} |
Vidu | err_code（string） | - | 空串 | 非空串 | {id, state, err_code, creations} |
MiniMax H3（模型厂商返回） | task.error.code（string） | task.error.message | 无 task.error | 有 task.error | {task:{id, model, status, error}} |
MiniMax H3（平台侧返回） | 顶层 error.type（string） | 顶层 error.message | 无顶层 error | 有顶层 error | {error:{type, message}} |
MiniMax 其他版本 | base_resp.status_code（number） | base_resp.status_msg | 0 | 非 0 | {task_id, base_resp} |
提交期 vs 生成期
模型厂商错误可能出现在两个不同阶段，处理动作不同：
阶段 | 触发时机 | 表现 | 处理动作 |
提交期 | 参数通过平台校验，但模型厂商拒绝 | 提交接口即返回错误信封 | 按描述修正输入内容，重新提交 |
生成期 | 任务已受理，生成过程中失败 | 提交成功，轮询时状态转为失败 | 修正输入后重新提交（非重试原请求） |
PixVerse
响应结构
提交成功：
{"ErrCode": 0,"ErrMsg": "success","Resp": { "video_id": "4-WandVideo-4ba31a7d508249b787fa0b0c62a6a399" },"request_id": "4d384c85-2177-4bae-adf9-364ed917509b"}
提交失败：
{"ErrCode": 400017,"ErrMsg": "invalid param","Resp": null,"request_id": "38615420-bb82-437e-8229-f97054a15364-query-1788749971"}
查询：
{"ErrCode":0,"ErrMsg":"Success","Resp":{ id, status, url, ... }}生成期失败体现在
Resp.status：7=内容审核失败、8=生成失败。错误码表
说明：
下表为响应体中的业务
ErrCode，不等同于 HTTP 状态码。Code | Description | 说明 |
0 | success | 成功 |
400011 | Empty parameter | 参数为空 |
400012 | Invalid account | 无效账号 |
400013 | Invalid binding request: incorrect parameter type or value | 无效绑定请求：参数类型或值错误 |
400017 | Invalid parameter | 参数无效 |
400018 | Prompt length exceeds limit | 提示词超过长度限制 |
400019 | Prompt / negative prompt length exceeds limit | 提示词或负向提示词超过长度限制 |
400032 | Invalid image ID | 图片 ID 无效 |
500008 | Requested data not found | 请求数据未找到 |
500020 | No permission | 当前账号无操作权限 |
500030 | Image size exceeded | 图片大小或分辨率超过限制 |
500031 | Failed to retrieve image information | 获取图片信息失败 |
500032 | Invalid image format | 图片格式无效 |
500033 | Invalid image width or height | 图片宽度或高度无效 |
500041 | Image upload failed | 图片上传失败 |
500042 | Invalid image path | 图片路径无效 |
500044 | Concurrent generation limit reached | 并发生成任务数已达上限 |
500054 | Content moderation failure | 内容审核未通过 |
500060 | Monthly effects activation limit reached | 本月特效激活次数已达上限 |
500063 | Pre-moderation failed | 输入内容触发前置审核，请重新输入或替换素材 |
500064 | Content has been deleted | 内容已被删除，请检查其他可用内容 |
500069 | High load | 系统负载过高，请稍后重试 |
500070 | Template not activated | 当前模板未激活 |
500071 | Unsupported resolution for effect | 当前特效不支持指定分辨率 |
500090 | Insufficient balance | 余额不足 |
500100 | Internal error | 服务内部错误，请稍后重试 |
10005 | apiKey is not registered | apikey 缺失、无效、过期或撤销 |
99999 | Unknown error | 未知错误 |
常见错误场景与处理建议
认证错误
错误示例：
Invalid API-KEY、10005可能原因：
请求头中的
API-KEY 错误或已失效。API Key 未激活、已撤销或已过期。
将 API Key 放入请求体，而不是请求头。
处理建议：
确认正在使用正确且已激活的 API Key。
确保请求头中包含
API-KEY。如问题仍然存在，请 提交工单 并提供
Request ID。参数错误
错误示例：
Invalid parameter（400017）、Invalid binding request（400013）处理建议：
检查参数类型是否正确。
检查模型、分辨率、时长、画幅比例等枚举值是否在支持范围内。
检查必填参数是否缺失。
检查提示词长度是否超过限制：文生视频
prompt 以接口说明为准；图生视频 prompt 最长 2048 characters。内容审核错误
错误示例：
Content moderation failure（500054）、Pre-moderation failed（500063）可能原因：
输入图片、视频或文本触发内容审核。
提示词包含不合规内容。
处理建议：
替换输入图片或视频。
调整提示词表达。
避免上传违规内容。
余额错误
错误示例：
Insufficient balance（500090）处理建议：
检查账号剩余额度。
降低生成规格，例如分辨率、时长或音频开关。
如需继续生成，请充值或升级套餐。
Kling（可灵）
响应结构
提交成功：
{"code": 0,"message": "SUCCEED","request_id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4","data": { "id": "task_xxxxxxxxxxxx", "status": "submitted", "message": "", "create_time": 1714000000000, "update_time": 1714000000000 }}
提交失败：
{ "code": 1201, "message": "<具体错误描述>", "request_id": "" }
查询：
{code, message, request_id, data:[...]}，生成期失败为 data[].status="failed" + data[].message。错误码表
HTTP 状态码 | 业务码 | 业务码定义 | 业务码解释 | 建议解决方案 |
200 | 0 | 请求成功 | - | - |
401 | 1000 | 身份验证失败 | 身份验证失败 | 检查 Authorization 是否正确 |
401 | 1001 | 身份验证失败 | Authorization 为空 | 在 Request Header 中填写正确的 Authorization |
401 | 1002 | 身份验证失败 | Authorization 值非法 | 在 Request Header 中填写正确的 Authorization |
401 | 1003 | 身份验证失败 | Authorization 未到有效时间 | 检查 token 的开始生效时间，等待生效或重新签发 |
401 | 1004 | 身份验证失败 | Authorization 已失效 | 检查 token 的有效期，重新签发 |
429 | 1100 | 账户异常 | 账户异常 | 检查账户配置信息 |
429 | 1101 | 账户异常 | 账户欠费（后付费场景） | 进行账户充值，确保余额充足 |
429 | 1102 | 账户异常 | 资源包已用完/已过期（预付费场景） | 购买额外的资源包，或开通后付费服务（如有） |
403 | 1103 | 账户异常 | 请求的资源无权限，如接口/模型 | 检查账户权限 |
400 | 1200 | 请求参数非法 | 请求参数非法 | 检查请求参数是否正确 |
400 | 1201 | 请求参数非法 | 参数非法，如 key 写错或 value 非法 | 参考返回体中 message 字段的具体信息，修改请求参数 |
404 | 1202 | 请求参数非法 | 请求的 method 无效 | 查看接口文档，使用正确的 request method |
404 | 1203 | 请求参数非法 | 请求的资源不存在，如模型 | 参考返回体中 message 字段的具体信息，修改请求参数 |
400 | 1300 | 触发策略 | 触发平台策略 | 检查是否触发平台策略 |
400 | 1301 | 触发策略 | 触发平台的内容安全策略 | 检查输入内容，修改后重新发起请求 |
429 | 1302 | 触发策略 | API 请求过快，超过平台速率限制 | |
429 | 1303 | 触发策略 | 并发或 QPS 超出预付费资源包限制 | |
429 | 1304 | 触发策略 | 触发平台的 IP 白名单策略 | |
500 | 5000 | 内部错误 | 服务器内部错误 | |
503 | 5001 | 内部错误 | 服务器暂时不可用，通常是在维护 | |
504 | 5002 | 内部错误 | 服务器内部超时，通常是发生积压 |
Vidu
响应结构
提交成功：
{"task_id":"...","state":"created"}查询：
{"id","state","err_code","creations":[...]}state：created / queueing / processing / success / failederr_code：字符串，失败时承载具体错误码；成功时为空串提交失败（创建即失败）： 模型厂商返回的错误体将原样透传。
错误码表
错误码 | 错误信息 | 错误描述 |
BadRequest | bad request | 不合法的请求 |
FieldLacking | field is missing or empty: {{.fields}} | 缺少字段，具体字段见错误信息 |
FieldUnwanted | unwanted field: {{.fields}} | 不需要传某些字段，具体字段见错误信息 |
FieldItemCountOutOfRange | field item count out of range: {{.fields}} | 字段超限制 |
PageSizeOutOfRange | page size out of range | 图像尺寸有问题。要求：图片大小需小于50M，格式只支持 jpg/jpeg/png/webp，图片长宽比需要小于1:4或者4:1，跳舞特效的图片长宽比需要在 1:1.2 至 1:2 之间 |
ImageDownloadFailure | image download failure | 下载用户图片 URL 失败，请检查链接的有效性 |
OperationInProcess | operation in process, please retry later | 请求在处理中 |
TaskPromptPolicyViolation | prompt policy violation | Prompt 触发安全审核风控 |
ImageFormatInvalid | invalid image format | 图像格式不符合要求 |
AuditSubmitIllegal | submit is illegal | 输入没有通过安全审核 |
CreditInsufficient | insufficient credits | 积分不足 |
CreationPolicyViolation | creation policy violation | 生成物触发风控 |
ModelUnavailable | model unavailable | 请求的模型不可用，调用任务失败，请检查模型类型并重试 |
UserCancelled | user cancelled | 用户手动终止任务执行 |
FieldInvalid | invalid field: {{.fields}} | 传入参数未通过合法性校验 |
ImageCheckBodyJointsFailed | Image Check Body Joints Failed | 输入图人体检测失败，请重新上传 |
ImageCheckFaceFailed | Image Check Face Failed | 输入图人脸检测失败，请重新上传 |
ImageObjectsUndetected | Image BodyJoints or Face Too Much Occlusion | 输入图的人体或人脸有遮挡，请重新上传 |
Unauthorized | unauthorized | 未鉴权 |
Forbidden | forbidden | 请求没有权限 |
TaskNotFound | task not found | Task id 没找到 |
CreationNotFound | creation not found | Creation id 没找到 |
NotFound | not found | 请求资源不存在 |
Conflict | resource conflict | 资源主键冲突 |
QuotaExceeded | quota exceeded | |
TooManyRequests | too many requests | 请求太频繁 |
SystemThrottling | system is throttling | 资源超过限制 |
Canceled | request canceled by client | 请求被取消 |
InternalServiceFailure | internal service failure | |
Unknown | unknown | 未知原因 |
FaceDetectFailure | face detect failure | 人脸检测失败 |
VideoDownloadFailure | video download failure | 视频下载失败 |
VideoFormatInvalid | video format invalid | 视频格式错误 |
FaceDetectNotPass | face detect not pass | 人脸检测不通过 |
PhotoAuditNotPass | photo audit not pass | 审核不通过 |
NoFaceDetected | no face detected | 检测不到人脸 |
MultiFaceDetected | multi face detected | 多人检测失败 |
AuditFailed | audit failed | 审核失败 |
ImageSizeInvalid | image size invalid | 图片尺寸过大/过小 |
MiniMax
MiniMax 存在两套协议，错误形态完全不同，须按模型版本区分。
H3 系列（含 H3 / H3-Max）
提交成功：
{"task_id":"..."}平台侧返回的提交失败：
{ "error": { "type": "invalid_request_error", "message": "<具体描述>" } }
error.type 取值如下：HTTP | error.type |
400 | invalid_request_error |
429 | rate_limit_error |
402 | insufficient_balance_error |
401 / 403 | authentication_error |
其余 | internal_error |
查询：
{task:{id, model, status, content, error}, request_id}task.status：queued / running / succeeded / failed / cancelled / expiredtask.error：{code, message}，失败时返回；模型厂商未返回错误码时，code 兜底为字符串 "internal_error"其他版本（base_resp 风格）
提交成功：
{"task_id":"...","base_resp":{"status_code":0,"status_msg":"success"}}平台侧返回的提交失败：
{ "base_resp": { "status_code": 2013, "status_msg": "<具体描述>" } }
场景 | HTTP | base_resp.status_code |
限流 | 429 | 1002 |
参数/校验错误 | 400 | 2013 |
MiniMax 模型厂商返回的失败：
base_resp 原样透传，status_code 取值见下方错误码表（如 1008 余额不足、1024 内部错误、1026 输入内容涉敏）。错误码表
错误码 | 含义 | 解决方法 |
1000 | 未知错误/系统默认错误 | 请稍后再试 |
1001 | 请求超时 | 请稍后再试 |
1002 | 请求频率超限 | 请稍后再试 |
1004 | 未授权/Token 不匹配/Cookie 缺失 | 请检查 API Key |
1008 | 余额不足 | 请检查您的账户余额 |
1024 | 内部错误 | 请稍后再试 |
1026 | 输入内容涉敏 | 请调整输入内容 |
1027 | 输出内容涉敏 | 请调整输入内容 |
1033 | 系统错误/下游服务错误 | 请稍后再试 |
1039 | Token 限制 | 请调整 max_tokens |
1041 | 连接数限制 | |
1042 | 不可见字符比例超限/非法字符超过 10% | 请检查输入内容，是否包含不可见字符或非法字符 |
2013 | 参数错误 | 请检查请求参数 |
2045 | 请求频率增长超限 | 请避免请求骤增骤减情况 |
2049 | 无效的 API Key | 请检查 API Key |
2056 | 超出 Token Plan 资源限制 | 请等待下一个时间段资源释放后，再次尝试 |
注意：
视频生成常见错误码：
1000、1001、1002、1004、1008、1024、1026、1027、1033、1039、1041、1042、2013、2045、2049、2056。如需反馈问题，请提供响应 Header 中的
Request ID（trace_id），以便排查。通用排查建议
四步定位法
1. 看 HTTP 状态码：如果状态码为非 2xx，且响应体为本平台形态（含
Code/Message 或顶层 error），则属于本平台错误，请查阅 API 错误码说明。如果状态码为 2xx，通常为模型厂商业务错误，请查阅本文档（平台侧返回的错误除外，见下方兜底判断）。2. 定位错误字段：按各模型厂商错误字段位置表找到对应厂商的错误字段位置。
3. 判断阶段：提交接口返回的错误属于提交期，轮询接口返回的错误属于生成期。
4. 按描述修正：错误描述（
ErrMsg / message / err_code / error.message）通常已指出具体原因。兜底判断：区分模型厂商错误与平台侧错误
平台在鉴权、限流或参数校验不通过时，会按对应厂商的响应格式返回错误，此时外层 HTTP 状态码可能仍为 2xx，但错误码由平台侧产生。若错误字段的值是下表中的取值，即属平台侧返回：
厂商 | 平台侧返回值 |
PixVerse | ErrCode = 400 / 429 |
Kling | code = 1201（对应 400）/ 1303（对应 429） |
MiniMax H3 | error.type = invalid_request_error / rate_limit_error |
MiniMax 其他版本 | base_resp.status_code = 2013（对应 400）/ 1002（对应 429） |
收到这些值时，处理动作是“修正请求参数”或“降低调用频率”，无需按模型厂商侧问题排查。其余取值请按 PixVerse、Kling、Vidu、MiniMax 各章节的错误码处理。
注意：
部分平台侧返回值与模型厂商错误码同值（例如 Kling 的
1201/1303、MiniMax 其他版本的 2013/1002），无法仅凭码值区分来源，但两者处理动作一致（修参数 / 降频），不影响排查结论。高频问题速查表
下表按语义归纳常见现象与处理方式，各错误码的准确定义以上方各厂商正文表格为准。
现象 | 可能的厂商错误码 | 处理 |
提示词超长 | PixVerse 400018/400019；Vidu FieldInvalid | 缩短提示词，注意图生视频 prompt 上限 2048 字符 |
图片格式/尺寸不合规 | PixVerse 500030/500032/500033；Vidu ImageFormatInvalid/ImageSizeInvalid | 检查格式（jpg/jpeg/png/webp）、大小（<50M）、长宽比 |
图片 URL 无法下载 | PixVerse 500041/500042；Vidu ImageDownloadFailure | 确认 URL 公网可访问、未过期、非内网地址 |
内容审核未通过 | PixVerse 500054/500063；Vidu AuditSubmitIllegal/PhotoAuditNotPass/AuditFailed；MiniMax 1026/1027 | 替换素材或调整提示词表达 |
并发超限 | PixVerse 500044；Vidu QuotaExceeded；Kling 1303；MiniMax 1002/2045 | 降低请求频率或并发，稍后重试 |
余额/积分不足 | PixVerse 500090；Vidu CreditInsufficient；MiniMax 1008 | 充值或降低生成规格 |
模型不可用 | Vidu ModelUnavailable；Kling 1203 | 检查 model 参数取值是否正确 |
服务异常/繁忙 | PixVerse 500069；Kling 5000/5001/5002；MiniMax 1000/1024/1033 |
提交工单
必要信息 | 说明 |
Request ID | 响应中的 request_id，是排查问题的唯一索引。 |
厂商错误原文 | 完整的 ErrCode/code/err_code/error 字段值。 |
请求时间 | 出错的大致时间点。 |
请求参数 | 使用的 model、分辨率、时长、画幅等。 |
完整响应 | 错误响应 JSON 全文。 |
