错误码参考
HTTP 错误码
| HTTP |
code |
说明 |
处理建议 |
| 400 |
invalid_request |
请求体 JSON 格式错误 |
检查请求 body 是否为合法 JSON |
| 400 |
validation_failed |
model 或 prompt 为空 |
填写 model 和 prompt |
| 400 |
invalid_params |
参数校验失败（mode 错误、互斥冲突等） |
根据 message 提示修正参数 |
| 400 |
missing_param |
task_id 缺失 |
确保请求路径包含 task_id |
| 401 |
unauthorized |
API Key 无效或缺失 |
检查 Authorization 请求头格式 |
| 404 |
task_not_found |
任务不存在或已过期 |
确认 task_id 是否正确 |
| 404 |
video_not_ready |
视频尚未生成完成 |
等待任务完成后重试 |
| 409 |
idempotent_task_active |
同一 client_task_id 已有进行中的任务 |
使用原 task_id 查询任务，不要重复提交 |
| 409 |
idempotent_task_completed |
同一 client_task_id 已有完成任务 |
使用原 task_id 查询任务，不要重复提交 |
| 410 |
video_retrieval_failed |
视频取回失败 |
使用同一个 client_task_id 重新提交 |
| 429 |
rate_limit_exceeded |
超过速率限制 |
降低请求频率，稍后重试 |
| 500 |
generation_failed |
创建任务失败 |
稍后重试，如持续失败请联系支持 |
| 500 |
download_failed |
视频下载失败 |
稍后重试 |
| 500 |
adapter_error |
服务组件异常 |
联系技术支持 |
| 500 |
proxy_failed |
请求转发失败 |
稍后重试 |
| 503 |
service_unavailable |
服务暂不可用、资源繁忙 |
稍后重试；如持续出现可切换模型或联系技术支持 |
常见校验错误
服务暂不可用
| 错误信息 |
原因 |
解决 |
| 当前生成线路不可用，请稍后重试 |
当前模型暂时无法创建新任务 |
稍后重试；如持续出现可切换其他同类模型 |
| 当前生成资源繁忙，请稍后重试 |
当前生成资源繁忙 |
降低并发并稍后重试 |
| 服务暂时不可用，请稍后重试 |
生成服务临时不可用 |
稍后重试；如持续出现请联系技术支持 |
model 相关
| 错误信息 |
原因 |
解决 |
| 模型名称不能为空 |
未传 model 字段 |
添加 model 参数 |
| 未知模型：xxx |
模型名称不在支持列表中 |
检查拼写，参见模型能力 |
prompt 相关
| 错误信息 |
原因 |
解决 |
| 提示词不能为空 |
prompt 为空或未传 |
提供有效的提示词 |
| prompt 字符数不能超过 %d |
超过对应模型的提示词长度限制 |
缩减提示词，或换用支持更长提示词的模型 |
| 提示词包含非法字符 |
prompt 含特殊控制字符 |
移除非法字符 |
mode 相关
| 错误信息 |
原因 |
解决 |
| mode 为必填项（references/frames） |
未传 mode |
添加 mode 参数 |
| mode 必须是 references 或 frames |
mode 值不合法 |
使用两个枚举值之一 |
| frames 模式下必须提供 frames 参数 |
frames 模式未传 frames |
添加 frames 对象 |
| frames 模式下 first_frame 为必填项 |
缺少首帧 |
提供 first_frame |
| frames 模式下 last_frame 为必填项 |
缺少尾帧 |
提供 last_frame |
| 当前模型不支持 frames 模式 |
模型不支持 frames 模式 |
换用支持的模型（CH04/CH06） |
references 互斥
| 错误信息 |
原因 |
解决 |
| image 和 images 互斥，只能传其中一个 |
同时传了单数和复数 |
只保留一个 |
| video 和 videos 互斥，只能传其中一个 |
同时传了单数和复数 |
只保留一个 |
| audio 和 audios 互斥，只能传其中一个 |
同时传了单数和复数 |
只保留一个 |
| 只有1张图片请使用 image，不要使用 images |
images 数组只有 1 个元素 |
改用 image |
| 只有1个视频请使用 video，不要使用 videos |
videos 数组只有 1 个元素 |
改用 video |
| 只有1个音频请使用 audio，不要使用 audios |
audios 数组只有 1 个元素 |
改用 audio |
| images 不能为空数组，请至少提供2个元素或改用 image |
images 为空数组 |
填元素或改用 image |
| videos 不能为空数组，请至少提供2个元素或改用 video |
videos 为空数组 |
填元素或改用 video |
| audios 不能为空数组，请至少提供2个元素或改用 audio |
audios 为空数组 |
填元素或改用 audio |
参数约束
| 错误信息 |
说明 |
解决 |
| 画面比例必须是 16:9、9:16、4:3、3:4、1:1 或 21:9 |
aspect_ratio 不在通用枚举中 |
使用支持的值 |
| 分辨率必须以模型约束为准 |
resolution 不在模型支持范围内 |
使用对应模型支持的值 |
| 视频时长必须在 %d-%d 秒之间 |
duration 超出通用范围 |
调整时长 |
| 模型 %s 必须提供 duration（5-15秒） |
旧模型必填 duration |
添加 duration |
| 模型 %s 最多 %d 张参考图片（当前 %d 张） |
参考图数量超限 |
减少参考图 |
| 模型 %s 不支持参考视频 |
模型不支持参考视频 |
移除 video/videos |
| 模型 %s 不支持参考音频 |
模型不支持参考音频 |
移除 audio/audios |
| 模型 %s 不支持 resolution 参数 |
旧模型不支持 resolution |
移除 resolution |
通用参数
| 错误信息 |
原因 |
解决 |
| 模型名称格式不正确，只能包含字母、数字、下划线、连字符和点号 |
model 含特殊字符 |
修正 model 名称 |
| 参考图片 URL 格式不正确 |
image URL 校验失败 |
检查 URL 格式 |
| 参考视频 URL 格式不正确 |
video URL 校验失败 |
检查 URL 格式 |
| 参考音频 URL 格式不正确 |
audio URL 校验失败 |
检查 URL 格式 |
| 首帧图片 URL 格式不正确 |
first_frame URL 校验失败 |
检查 URL 格式 |
| 尾帧图片 URL 格式不正确 |
last_frame URL 校验失败 |
检查 URL 格式 |
%s 为模型名，%d 为数值参数，实际返回时已被替换为具体值。
