创建视频生成任务

提交 Seedance 2.0 异步生成请求并获得统一任务 ID。

最后更新: 2026-08-06

POST/api/v1/video/task/create

创建一个视频生成任务；需要 Bearer API Key。

请求参数

参数	类型	要求	说明
`model`	string	必填	模型编码，当前固定为 doubao-seedance-2-0-260128。
`content`	object[]	必填	有序输入内容，1-20 项；每项都按下方 content 字段校验。
`resolution`	string	可选	480p、720p 或 1080p，默认 480p；Fast 和 Mini 处理通道型号不支持 1080p。
`ratio`	string	可选	16:9、9:16、3:4、1:1、4:3、21:9 或 adaptive，默认 16:9；Mini 处理通道型号不支持 adaptive。
`duration`	integer	可选	-1 或 4-15 秒，默认 5 秒。Mini 不支持 -1。
`watermark`	boolean	可选	是否添加水印，默认 false。
`seed`	integer	可选	随机种子，范围 -1 至 4294967295。
`returnLastFrame`	boolean	可选	是否返回生成视频的最后一帧图片，默认 false；true 会由处理通道接收为 return_last_frame=true。
`generateAudio`	boolean	可选	是否自动生成同步音频，默认 false；仅 Standard 处理通道型号支持。
`executionExpiresAfter`	integer	可选	任务执行过期时间，3600-259200 秒，默认 172800 秒。

content 字段

参数	类型	要求	说明
`type`	string	必填	text、image_url、video_url、audio_url 或 asset，不区分大小写。
`text`	string	可选	type=text 时必填，最多 5000 个字符。
`url`	string	可选	URL 类型时必须传入以 http:// 或 https:// 开头的地址，最多 2000 个字符；接口不解析 DNS、不判断公网/私网，也不预检可达性。
`assetId`	string	可选	type=asset 时必填，必须是当前账户处于 ACTIVE 状态的素材公开 ID，格式为 asset-{32位小写无连字符UUID}{2位数字}。
`role`	string	可选	图片允许 first_frame、last_frame、reference_image；视频仅允许 reference_video；音频仅允许 reference_audio。图片未传 role 时默认 first_frame；last_frame 仅 Standard 处理通道型号支持。

文生视频示例

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "城市天台的日落延时摄影，云层缓慢流动，电影质感"
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "watermark": false,
  "returnLastFrame": true
}

图生视频示例

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "参考图片1和图片2，让人物自然转身并看向镜头，镜头缓慢推进"
    },
    {
      "type": "image_url",
      "url": "https://example.com/reference-1.png",
      "role": "reference_image"
    },
    {
      "type": "image_url",
      "url": "https://example.com/reference-2.png",
      "role": "reference_image"
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "watermark": false
}

视频生视频示例

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "保持视频1的镜头运动，将画面转换为电影级东方幻想风格"
    },
    {
      "type": "video_url",
      "url": "https://example.com/reference.mp4",
      "role": "reference_video"
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "watermark": false
}

素材引用生视频示例

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "参考图片1中的人物，让人物自然转身并看向镜头，镜头缓慢推进"
    },
    {
      "type": "asset",
      "assetId": "asset-aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa01",
      "role": "reference_image"
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "watermark": false
}

result 响应字段

字段	类型	说明
taskId	string	EaseRouter 统一任务编号，格式为 task_{32位无连字符UUID}{5位随机数字}。
status	string	创建成功后为 QUEUED。
model	string	实际请求模型编码。
createdAt	datetime	任务创建时间，格式 yyyy-MM-dd HH:mm:ss。
requestId	string	本次 HTTP 请求追踪 ID。