1. 8. 错误处理与返回码
Seedance2.0-API接口文档(haomaotoken.com)
  • Seedance 2.0 视频生成 API 文档(Haomao 中转)
    • 前言
    • 创建令牌
    • 1. 快速开始
      • 1.1 文生视频调用流程
      • 1.2 图生视频调用流程
      • 1.3 完整请求
    • 2. 鉴权说明
      • 2.1 Authorization 请求头
    • 3. 创建视频生成任务
      • 3.1 接口信息
      • 3.2 请求参数
      • 3.3 文生视频请求示例
      • 3.4 图生视频请求示例
      • 3.5 正常返回包
    • 4. 查询视频生成任务
      • 4.1 接口信息
      • 4.2 路径参数
      • 4.3 请求示例
      • 4.4 响应示例:处理中
      • 4.5 响应示例:成功
      • 4.6 响应示例:失败
      • 4.7 任务状态说明
    • 5. 上传图片接口
      • 5.1 接口信息
      • 5.2 请求头
      • 5.3 表单参数
      • 5.4 请求示例
      • 5.5 正常返回包
      • 5.6 响应字段说明
    • 6. 查询文件接口
      • 6.1 接口信息
      • 6.2 路径参数
      • 6.3 请求示例
      • 6.4 正常返回包
      • 6.5 响应字段说明
    • 7. 完整演示代码
      • 7.1 Python 图生视频完整示例
      • 7.2 Node.js 图生视频完整示例
      • 7.3 Python 文生视频完整示例
    • 8. 错误处理与返回码
      • 8.1 错误返回包格式
        GET
      • 8.2 HTTP 状态码
        GET
      • 8.3 业务错误码
        GET
      • 8.4 建议重试策略
        GET
    • 9. 最佳实践
      • 9.1 提示词建议
      • 9.2 图生视频图片建议
      • 9.3 安全与合规
    • 10. 接口速查
      • 10.1 创建视频任务
      • 10.2 查询视频任务
      • 10.3 上传图片
      • 10.4 查询文件
  1. 8. 错误处理与返回码

8.3 业务错误码

GET
/

业务错误码#

错误码说明处理建议
BadRequest请求参数错误检查请求体、字段类型、必填参数。
Unauthorized鉴权失败检查令牌是否正确、是否过期。
Forbidden无权限检查账号权限、模型权限、额度。
NotFound资源不存在检查 task_id、file_id 或接口路径。
RateLimitExceeded触发限流降低并发和轮询频率。
InvalidFile文件无效检查文件是否损坏、格式是否支持。
FileTooLarge文件过大压缩图片或降低分辨率。
InvalidImageUrl图片 URL 无效确认文件查询接口返回的 url 可访问。
GenerationFailed视频生成失败调整提示词、图片或参数后重试。
UpstreamError上游服务异常稍后重试或联系支持。
InternalServerError服务内部错误稍后重试。
具体错误码以接口实际返回为准。这里整理的是常见错误码和建议处理方式。

请求参数

无

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{}
修改于 2026-09-09 09:17:18
上一页
8.2 HTTP 状态码
下一页
8.4 建议重试策略
Built with