3. 错误码
GET
/docs/v2/errors
1. 错误返回格式
{"error": {"message": "模型 doubao-seedance-2.0-720p 的 seconds 取值范围是 4–15", "type": "invalid_request_error", "param": "seconds", "code": "invalid_parameter"}}| 字段 | 说明 |
|---|---|
| message | 可以直接展示给用户的说明，默认中文（账户里设置了其他语言，或请求头 Accept-Language 指定了语言时，鉴权、余额、限流类报错按该语言返回）；末尾可能带 (request id: xxx)，反馈问题时请一并提供 |
| type | 错误大类 |
| param | 出错的参数名，与参数无关的错误没有这个字段 |
| code | 错误码，程序判断请用它，不要解析 message |
2. 错误码
| HTTP 状态码 | type | code | 含义 | 处理建议 |
|---|---|---|---|---|
| 400 | invalid_request_error | missing_required_parameter | 缺少必填字段 | 按 param 补齐 |
| 400 | invalid_request_error | invalid_parameter | 取值不合法，或超出该模型允许的范围 | 按模型能力表修正 |
| 400 | invalid_request_error | unsupported_parameter | 当前模型不支持这个字段 | 去掉该字段，或换用支持的模型 |
| 400 | invalid_request_error | parameter_conflict | 字段互相冲突，例如 size 与 aspect_ratio 同时传、首尾帧与参考素材混用 | 按提示保留其一 |
| 400 | invalid_request_error | invalid_media | 素材无法读取（不是有效链接或 data URL、下载失败）、类型不对或超过大小上限 | 确认链接可公网访问，素材类型和大小符合能力表要求 |
| 400 | invalid_request_error | unsupported_model | 模型不存在，或暂不支持 v2 接口 | 换用能力表中的模型 |
| 400 | invalid_request_error | video_not_ready | 下载视频时任务还没完成 | 等 status 变为 completed 后再下载 |
| 400 | invalid_request_error | upstream_rejected | 模型服务拒绝了请求（如内容安全审核），原因见 message；图像接口在模型没有出图时也返回此码 | 按原因修改提示词或素材 |
| 400 | invalid_request_error 等 | 模型服务原样给出的错误码 | 图像接口的模型服务直接报错时，按 OpenAI 格式原样返回，如 moderation_blocked | 按 message 修改请求 |
| 400 | new_api_error | sensitive_words_detected | 提示词包含平台设置的敏感词 | 修改提示词 |
| 401 | new_api_error | 空 | 令牌缺失或无效 | 检查 Authorization 请求头 |
| 403 | new_api_error | insufficient_user_quota | 账户余额不足 | 充值后重试 |
| 403 | new_api_error | access_denied 或空 | 令牌无权访问，例如 IP 不在令牌白名单、无权使用该分组 | 检查令牌设置 |
| 404 | invalid_request_error | video_not_found | 任务不存在，或不属于当前账户 | 检查 video_id |
| 429 | new_api_error | 空 | 请求过于频繁（图像接口；视频接口不限制请求次数） | 降低频率，稍后重试 |
| 502 | server_error | upstream_error | 生成服务异常 | 稍后重试 |
| 503 | server_error | service_unavailable | 模型暂时繁忙，或平台暂时不可用 | 稍后重试 |
| 503 | new_api_error | model_not_found | 当前分组暂时没有该模型的可用资源 | 稍后重试，或联系我们确认分组权限 |
| 503 | new_api_error | system_cpu_overloaded / system_memory_overloaded / system_disk_overloaded | 平台负载过高，暂停接收新的图像请求（message 为英文） | 稍后重试 |
3. 视频任务失败（查询结果 status=failed）
| error.code | 含义 |
|---|---|
| generation_failed | 生成失败，原因见 error.message，例如提示词或素材未通过内容安全审核 |
| timeout | 超过 30 分钟未完成，任务已取消 |
4. 重试建议
请求参数
无
请求示例代码
返回响应
修改于 2026-09-30 13:54:50