请求校验规则
请求在提交到上游模型前会进行多层校验。校验失败时不会创建任务，也不会返回可查询的任务 ID。
校验流程
请求接收
↓
认证检查 → 失败返回 401/403
↓
通用前置检查 → 失败返回参数错误
↓
模型能力检查 → 失败返回模型不支持错误
↓
提交任务 → 成功返回 task_id通用校验规则
模型检查
model字段必须是已开通的本站模型- 模型 ID 必须存在于账户已开通模型列表中
- 未开通的模型返回
invalid_request错误
提示词检查
prompt字段必须存在- 不能为空字符串
- UTF-8 字节数不能超过模型配置的最大值
- 超过限制返回
prompt_too_long错误
时长检查
seconds必须是整数（不接受浮点数）- 必须符合模型配置的最小值、最大值或固定值集合
- 失败返回
invalid_seconds错误
画幅检查
aspect_ratio只能填写模型允许的值（如16:9、9:16等）Auto是否支持由模型配置决定- 不支持的比例返回
invalid_aspect_ratio错误
清晰度检查
resolution只能填写模型支持的清晰度- 不支持的清晰度返回
invalid_resolution错误
参考素材校验
基本结构
references数组中每一项必须包含type、role、source三个字段- 缺少字段或字段类型错误返回
invalid_references错误
素材类型和数量
- 图片参考过多返回
too_many_reference_images错误 - 视频参考过多返回
too_many_reference_videos错误 - 音频参考过多返回
too_many_reference_audios错误 - 总数超限返回
too_many_reference_materials错误 - 视频与音频组合超限返回
too_many_video_audio_references错误
URL 校验
- 视频参考不接受 Base64 或
data:格式，返回video_base64_not_allowed错误 - URL 必须是可访问的公网 HTTPS 地址
- URL 格式或不可公网访问返回
invalid_reference_url错误 - 前置检查仅验证格式，不下载素材；实际取用时仍可能因过期而失败
校验后的保证
✓ 参数通过所有校验意味着：
- 格式和能力符合要求
- 模型配置支持该请求
✗ 但不保证：
- 上游模型一定生成成功
- 素材链接在任务实际开始前不会过期
- 最终视频质量符合预期
常见校验错误处理
重试策略
- 校验失败：不要盲目重复提交，应先修正错误
- 创建成功：获得
task_id后，后续使用该 ID 查询结果 - 网络超时：若不确定是否已创建，先用之前的
task_id查询，避免重复扣费