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.4 建议重试策略

GET
/

建议重试策略#

创建任务失败：只对网络错误、429、5xx 进行有限重试。
查询任务状态：建议每 3～10 秒查询一次，避免高频轮询。
上传图片失败：检查文件路径、文件大小、文件格式和令牌权限。
任务失败：读取 error.code 和 error.message，根据提示词、图片内容和参数重新提交。
不建议对同一个创建任务请求无限重试，避免重复扣费或重复生成。

请求参数

无

请求示例代码

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.3 业务错误码
下一页
9.1 提示词建议
Built with