错误码与排查
识别认证错误、参数错误、限流、任务失败和下载错误
HTTP 错误
| 状态码 | 含义 | 处理建议 |
|---|---|---|
400 | 请求参数或任务 ID 无效 | 检查错误码、字段层级、枚举与必填项 |
401 | 未认证 | 检查 Bearer Token 格式与有效性 |
403 | 无权限或内容地址不允许 | 检查任务归属、模型权限和下载目标 |
404 | 路径或资源不存在 | 检查 Base URL、接口路径与任务 ID |
429 | 请求过多或额度受限 | 降低频率,按响应信息退避重试 |
5xx | 服务或上游异常 | 记录任务 ID 和时间,有限次重试 |
参数错误
| 错误码 | 说明 |
|---|---|
missing_model | OpenAI 视频创建请求缺少 model |
invalid_request | 请求体无法解析或缺少 prompt |
invalid_seconds | 时长格式错误或超出允许范围 |
invalid_resolution | 分辨率不在允许枚举中,或模型不支持该分辨率 |
invalid_ratio | 画幅比不是 16:9、9:16、1:1 |
invalid_content | metadata.content 结构或媒体项无效 |
unsupported_field | Seedance 请求包含未支持的顶层字段或文件字段 |
task_not_exist | 任务不存在或不属于当前 Token 用户 |
任务进入 failed 后,错误位于火山响应的 data.error 或 OpenAI 响应的顶层 error。任务失败是终态,不应继续轮询。
最后更新于