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.2 请求参数

POST
/api/v3/contents/generations/tasks

请求参数#

参数类型必填说明
modelstring是Seedance 2.0 模型名称,请使用 Haomao 支持的模型标识。
contentarray是输入内容数组,可包含文本、图片等多模态内容。
content[].typestring是内容类型,常见值:text、image_url。
content[].textstring否文本提示词,当 type=text 时使用。
content[].image_urlobject否图片输入,当 type=image_url 时使用。
content[].image_url.urlstring否图片 URL,图生视频时填写查询文件接口返回的 url。
durationinteger否视频时长,单位通常为秒,具体取值以模型支持为准。
ratiostring否视频比例,例如 16:9、9:16、1:1。
resolutionstring否视频分辨率,例如 720p、1080p。
seedinteger否随机种子。
guidance_scalenumber否提示词引导强度。
watermarkboolean否是否添加水印。

请求参数

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",
  "seed": 12345,
  "guidance_scale": 7.5,
  "watermark": false
}

请求示例代码

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",
  "seed": 12345,
  "guidance_scale": 7.5,
  "watermark": false
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{}
修改于 2026-09-09 09:17:18
上一页
3.1 接口信息
下一页
3.3 文生视频请求示例
Built with