Video Gen API 开发者文档
使用指南火山兼容APIOpenAI 兼容API在线调试帮助支持

错误码与排查

识别认证错误、参数错误、限流、任务失败和下载错误

HTTP 错误

状态码含义处理建议
400请求参数或任务 ID 无效检查错误码、字段层级、枚举与必填项
401未认证检查 Bearer Token 格式与有效性
403无权限或内容地址不允许检查任务归属、模型权限和下载目标
404路径或资源不存在检查 Base URL、接口路径与任务 ID
429请求过多或额度受限降低频率,按响应信息退避重试
5xx服务或上游异常记录任务 ID 和时间,有限次重试

参数错误

错误码说明
missing_modelOpenAI 视频创建请求缺少 model
invalid_request请求体无法解析或缺少 prompt
invalid_seconds时长格式错误或超出允许范围
invalid_resolution分辨率不在允许枚举中,或模型不支持该分辨率
invalid_ratio画幅比不是 16:99:161:1
invalid_contentmetadata.content 结构或媒体项无效
unsupported_fieldSeedance 请求包含未支持的顶层字段或文件字段
task_not_exist任务不存在或不属于当前 Token 用户

任务进入 failed 后,错误位于火山响应的 data.error 或 OpenAI 响应的顶层 error。任务失败是终态,不应继续轮询。

最后更新于