创建视频任务

创建 Seedance 视频生成任务，基于传入的图片、视频、音频及文本提示词生成视频。任务为异步流程，返回任务 ID 后通过查询接口轮询结果。

三种生成模式

接口支持三种生成模式，通过 content 数组中传入的内容类型和 role 区分。三种模式互斥，单次请求只能选择其一，不可混用。

模式	输入	说明
文生视频	仅文本提示词	从文字描述生成全新视频
图生视频	1~2 张图片 + 文本（可选）	首帧（`first_frame`）或首尾帧（`first_frame` + `last_frame`）引导生成
多模态参考生视频	参考图（0~9）+ 参考视频（0~3）+ 参考音频（0~3）+ 文本（可选）	至少含 1 个图片或视频，支持生成全新视频、编辑视频、延长视频

三种模式互斥：例如不能在同一个请求里既用 first_frame/last_frame（图生视频）又用 reference_image/reference_video（多模态参考）。

文生视频

仅传入文本提示词：

{
  "model": "doubao-seedance-2-0-fast",
  "content": [
    { "type": "text", "text": "一只橘猫在阳光下的窗台上伸懒腰，镜头缓慢推进" }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5
}

图生视频

首帧：传入 1 张图片，role 为 first_frame（或不填）：

{
  "model": "doubao-seedance-2-0",
  "content": [
    { "type": "text", "text": "镜头缓缓拉远，画面中的人物转身微笑" },
    { "type": "image_url", "image_url": { "url": "https://example.com/first.jpg" }, "role": "first_frame" }
  ]
}

首尾帧：传入 2 张图片，role 分别为 first_frame 和 last_frame（均必填）：

{
  "model": "doubao-seedance-2-0",
  "content": [
    { "type": "text", "text": "花朵从含苞到盛开" },
    { "type": "image_url", "image_url": { "url": "https://example.com/start.jpg" }, "role": "first_frame" },
    { "type": "image_url", "image_url": { "url": "https://example.com/end.jpg" }, "role": "last_frame" }
  ]
}

多模态参考生视频

传入参考图、参考视频、参考音频（带 reference_* 角色），不可单独输入音频：

{
  "model": "doubao-seedance-2-0",
  "content": [
    { "type": "text", "text": "这个人在唱歌，口型与音频同步" },
    { "type": "image_url", "image_url": { "url": "asset://asset-xxxx" }, "role": "reference_image" },
    { "type": "audio_url", "audio_url": { "url": "https://example.com/voice.mp3" }, "role": "reference_audio" }
  ],
  "generate_audio": true
}

Authorization

BearerAuth

AuthorizationBearer <token>

Authorization: Bearer <你的 API 密钥>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

model*string

模型 ID

Value in"doubao-seedance-2-0" | "doubao-seedance-2-0-fast"

content*array<>

输入给模型、生成视频的信息，支持文本、图片、音频、视频。支持以下组合：文本 / 文本（可选）+ 图片 / 文本（可选）+ 视频 / 文本（可选）+ 图片 + 音频 / 文本（可选）+ 图片 + 视频 / 文本（可选）+ 视频 + 音频 / 文本（可选）+ 图片 + 视频 + 音频。

callback_url?string

生成任务结果的回调通知地址。当任务状态变化时，将向此地址推送 POST 请求。回调返回的 status 包括：queued、running、succeeded、failed、expired。

return_last_frame?boolean

是否返回生成视频的尾帧图像。true 时可通过查询接口获取视频尾帧（png 格式，无水印），用于以上一个视频尾帧作为下一个任务首帧，生成多个连续视频。

Defaultfalse

execution_expires_after?integer

任务超时阈值（秒），从创建时间开始计算。超过后任务自动终止并标记为 expired。取值范围 [3600, 259200]。

Default172800

generate_audio?boolean

是否生成与画面同步的声音。true 时模型自动生成人声、音效及背景音乐；false 为无声视频。生成的有声视频均为单声道。

Defaulttrue

safety_identifier?string

终端用户的唯一标识符（英文字符串，≤64 字符），用于平台检测违规用户。推荐传入用户名/ID/邮箱的哈希值。

priority?integer

请求执行优先级，决定队列中的排序位置。取值范围 0~9，数值越大优先级越高。默认按 FIFO 排序，设置高优先级将插队到同 Endpoint 下低优先级请求之前。仅影响排队顺序，不中断运行中任务。

Default0

Range0 <= value <= 9

resolution?string

视频分辨率。Seedance 2.0 fast 不支持 1080p。

Default"720p"

Value in"480p" | "720p" | "1080p"

ratio?string

生成视频的宽高比。adaptive 表示根据输入自动选择最合适的宽高比（文生视频按提示词智能选择，首帧/首尾帧按首帧图片比例自动选择）。

Default"adaptive"

Value in"16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "21:9" | "adaptive"

duration?integer

生成视频时长（秒，仅整数）。Seedance 2.0 系列取值 [4, 15]，或设为 -1 表示由模型在有效范围内自主选择。与 frames 二选一，frames 优先级更高。

Default5

seed?integer

种子整数，控制生成内容的随机性。取值范围 [-1, 2^32-1]。相同 seed 生成类似结果但不保证完全一致；不指定或 -1 使用随机数。

Default-1

watermark?boolean

生成视频是否包含水印。true 时右下角展示「AI 生成」水印。

Defaultfalse

tools?array<>

配置模型要调用的工具。仅文生视频场景支持。

Response Body

`application/json`

curl -X POST "https://api.3hei.com/v1/videos" \  -H "Content-Type: application/json" \  -d '{    "model": "doubao-seedance-2-0",    "content": [      {        "type": "text"      }    ]  }'

{
  "id": "cgt-20250615xxxxxxxx"
}