1. 3. 创建视频生成任务
Seedance2.0-API接口文档(haomaotoken.com)
  • Seedance 2.0 视频生成 API 文档(Haomao 中转)
    • 前言
    • 创建令牌
    • 1. 快速开始
      • 1.1 文生视频调用流程
      • 1.2 图生视频调用流程
      • 1.3 完整请求
    • 2. 鉴权说明
      • 2.1 Authorization 请求头
    • 3. 创建视频生成任务
      • 3.1 接口信息
        POST
      • 3.2 请求参数
        POST
      • 3.3 文生视频请求示例
        POST
      • 3.4 图生视频请求示例
        POST
      • 3.5 正常返回包
        POST
    • 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 错误返回包格式
      • 8.2 HTTP 状态码
      • 8.3 业务错误码
      • 8.4 建议重试策略
    • 9. 最佳实践
      • 9.1 提示词建议
      • 9.2 图生视频图片建议
      • 9.3 安全与合规
    • 10. 接口速查
      • 10.1 创建视频任务
      • 10.2 查询视频任务
      • 10.3 上传图片
      • 10.4 查询文件
  1. 3. 创建视频生成任务

3.4 图生视频请求示例

POST
/api/v3/contents/generations/tasks

图生视频请求示例#

图生视频需要先上传图片,并通过查询文件接口获取图片 URL。
{
  "model": "doubao-seedance-2.0",
  "content": [
    {
      "type": "text",
      "text": "让图片中的人物缓慢转身看向镜头,背景有自然风吹动,电影感,真实质感"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://haomaotoken.com/files/file_1234567890/r2v_tea_pic1.jpg"
      }
    }
  ],
  "duration": 5,
  "ratio": "16:9",
  "resolution": "720p"
}

请求参数

Header 参数

Body 参数application/json

示例
{
  "model": "seedance-2.0",
  "content": [
    {
      "type": "text",
      "text": "让图片中的人物缓慢转身看向镜头,背景有自然风吹动,电影感,真实质感"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "{{image_url}}"
      }
    }
  ],
  "duration": 5,
  "ratio": "16:9",
  "resolution": "720p"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/v3/contents/generations/tasks' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data '{
  "model": "seedance-2.0",
  "content": [
    {
      "type": "text",
      "text": "让图片中的人物缓慢转身看向镜头,背景有自然风吹动,电影感,真实质感"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "{{image_url}}"
      }
    }
  ],
  "duration": 5,
  "ratio": "16:9",
  "resolution": "720p"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{}
修改于 2026-09-09 09:17:18
上一页
3.3 文生视频请求示例
下一页
3.5 正常返回包
Built with