创建视频生成任务

文档版本：v1.0.0 | 最后更新：2026-06-11
本平台已完整适配豆包 Seedance 系列官方视频生成接口，请求与响应均为透传，参数语义与官方一致。

通过多模态 content 数组提交文本、图片、视频、音频等内容，创建视频生成任务。

POST https://platform.shuyanai.com/seedance/api/v3/contents/generations/tasks

模型能力

Doubao Seedance 2.0 系列（有声视频/无声视频）

多模态参考生视频：输入参考图片（0~~9）+ 参考视频（0~~3）+ 参考音频（0~3）+ 文本提示词（可选）生成 1 个目标视频。注意不可单独输入音频，应至少包含 1 个参考视频或图片。

图生视频-首尾帧：输入首帧图片 + 尾帧图片 + 文本提示词（可选）生成 1 个目标视频。

图生视频-首帧：输入首帧图片 + 文本提示词（可选）生成 1 个目标视频。

文生视频：输入文本提示词生成 1 个目标视频。

Doubao Seedance 1.5 pro（有声视频/无声视频）

图生视频-首尾帧、图生视频-首帧、文生视频

Doubao Seedance 1.0 pro

图生视频-首尾帧、图生视频-首帧、文生视频

Doubao Seedance 1.0 pro fast

图生视频-首帧、文生视频

content 支持以下几种组合：

文本

文本（可选）+ 图片

文本（可选）+ 视频

文本（可选）+ 图片 + 音频

文本（可选）+ 图片 + 视频

文本（可选）+ 视频 + 音频

文本（可选）+ 图片 + 视频 + 音频

样片任务 ID：样片指使用 Seedance 模型成功生成的样片视频，模型可基于样片生成高质量正式视频。

请求参数

请求体

model string 必选

您需要调用的模型的 ID（Model ID）。您也可通过 Endpoint ID 来调用模型，获得限流、计费类型（前付费/后付费）、运行状态查询、监控、安全等高级能力。

content object[] 必选

输入给模型，生成视频的信息，支持文本、图片、音频、视频、样片任务 ID。

注意：Seedance 2.0 系列模型不支持直接上传含有真人人脸的参考图/视频。

注意：图生视频-首帧、图生视频-首尾帧、多模态参考生视频（包括参考图、视频、音频）为 3 种互斥场景，不可混用。

callback_url string

填写本次生成任务结果的回调通知地址。当视频生成任务有状态变化时，平台将向此地址推送 POST 请求。

回调请求内容结构与查询任务接口的返回体一致。

回调返回的 status 包括以下状态：

queued：排队中。

running：任务运行中。

succeeded：任务成功。（如发送失败，即 5 秒内没有接收到成功发送的信息，回调三次）

failed：任务失败。（如发送失败，即 5 秒内没有接收到成功发送的信息，回调三次）

expired：任务超时，即任务处于运行中或排队中状态超过过期时间。可通过 execution_expires_after 字段设置过期时间。

return_last_frame boolean 默认值 false

true：返回生成视频的尾帧图像。设置为 true 后，可通过查询视频生成任务接口获取视频的尾帧图像。尾帧图像的格式为 png，宽高像素值与生成的视频保持一致，无水印。使用该参数可实现生成多个连续视频：以上一个生成视频的尾帧作为下一个视频任务的首帧。

false：不返回生成视频的尾帧图像。

service_tier string 默认值 "default"

不支持修改已提交任务的服务等级
Seedance 2.0 系列仅支持在线推理模式，不支持配置该参数

指定处理本次请求的服务等级类型，枚举值：

default：在线推理模式，RPM 和并发数配额较低，适合对推理时效性要求较高的场景。

flex：离线推理模式，TPD 配额更高，价格为在线推理的 50%，适合对推理时延要求不高的场景。

execution_expires_after integer 默认值 172800

任务超时阈值。指定任务提交后的过期时间（单位：秒），从 created_at 时间戳开始计算。默认值 172800 秒，即 48 小时。取值范围：[3600, 259200]。

不论使用哪种 service_tier，都建议根据业务场景设置合适的超时时间。超过该时间后任务会被自动终止，并标记为 expired 状态。

generate_audio boolean 默认值 true

仅 Seedance 2.0 系列、Seedance 1.5 pro 支持

控制生成的视频是否包含与画面同步的声音。

true：模型输出的视频包含同步音频。模型会基于文本提示词与视觉内容，自动生成与之匹配的人声、音效及背景音乐。建议将对话部分置于双引号内，以优化音频生成效果。例如：男人叫住女人说："你记住，以后不可以用手指指月亮。"

false：模型输出的视频为无声视频。

注意：生成的有声视频均为单声道，和传入的音频声道数无关。

draft boolean 默认值 false

仅 Seedance 1.5 pro 支持

控制是否开启样片模式。

true：开启样片模式，生成一段预览视频，快速验证场景结构、镜头调度、主体动作与 prompt 意图是否符合预期。消耗 token 数较正常视频更少，使用成本更低。

false：关闭样片模式，正常生成一段视频。

说明：开启样片模式后，将使用 480p 分辨率生成 Draft 视频（使用其他分辨率会报错），不支持返回尾帧功能，不支持离线推理功能。

tools object[]

仅 Seedance 2.0 系列支持

配置模型要调用的工具。

字段	类型	说明
`tools.type`	string	工具类型。当前支持 `web_search`（联网搜索）

说明：开启联网搜索后，模型会根据用户的提示词自主判断是否搜索互联网内容（如商品、天气等）。可提升生成视频的时效性，但也会增加一定的时延。实际搜索次数可通过查询视频生成任务接口返回的 usage.tool_usage.web_search 字段获取。

safety_identifier string

终端用户的唯一标识符，用于协助平台检测应用中可能存在的违规用户。该标识符为英文字符串，需保证对单个用户固定且唯一，长度不超过 64 个字符。推荐传入对用户名、用户 ID 或邮箱进行哈希处理后生成的字符串，避免泄露用户隐私信息。

priority integer 默认值 0

仅 Seedance 2.0 系列支持

设置当前请求的执行优先级，决定其在队列中的排序位置。取值范围：0~9，数值越大，优先级越高。

默认情况下，请求按 FIFO（先进先出）顺序执行。设置较高优先级后，该请求将插队到同 Endpoint 下所有低优先级请求之前。

说明：
相同优先级的请求之间仍按 FIFO 排序。
优先级仅影响排队顺序，不会中断正在执行中（status=running）的任务。
优先级仅在同一 Endpoint 内生效，不影响其他 Endpoint。
离线推理模式（service_tier=flex）不支持配置优先级。

视频输出参数

参数升级说明：对于 resolution、ratio、duration、frames、seed、camera_fixed、watermark 参数，平台升级了参数传入方式。所有模型依然兼容支持旧方式。
新方式（推荐）：在 request body 中直接传入参数。此方式为强校验，若参数填写错误，模型会返回错误提示。
旧方式：在文本提示词后追加 --[parameters]（如 --resolution 720p --ratio 16:9）。此方式为弱校验，若参数填写错误，该参数将被忽略或触发报错。

resolution string

Seedance 2.0 系列、Seedance 1.5 pro 默认值：720p
Seedance 1.0 pro & pro-fast 默认值：1080p

视频分辨率，枚举值：

480p

720p

1080p：Seedance 2.0 fast 不支持

ratio string

Seedance 2.0 系列、Seedance 1.5 pro 默认值为 adaptive
其他模型：文生视频默认值 16:9，图生视频默认值 adaptive

生成视频的宽高比例，枚举值：

16:9

4:3

1:1

3:4

9:16

21:9

adaptive：根据输入自动选择最合适的宽高比

adaptive 适配规则：

文生视频：根据输入的提示词，智能选择最合适的宽高比。

首帧 / 首尾帧生视频：根据上传的首帧图片比例，自动选择最接近的宽高比。

多模态参考生视频：根据用户提示词意图判断，如果是首帧生视频/编辑视频/延长视频，以该图片/视频为准选择最接近的宽高比；否则，以传入的第一个媒体文件为准（优先级：视频＞图片）选择最接近的宽高比。

adaptive 仅 Seedance 2.0 系列、Seedance 1.5 Pro 全场景支持；其他模型仅图生视频场景支持。

duration integer 默认值 5

duration 和 frames 二选一即可，frames 的优先级高于 duration。如果您希望生成整数秒的视频，建议指定 duration。

生成视频时长，仅支持整数，单位：秒。

Seedance 1.0 pro、Seedance 1.0 pro fast：[2, 12] s

Seedance 1.5 pro：[4, 12] 或设置为 -1

Seedance 2.0 系列：[4, 15] 或设置为 -1

注意：Seedance 2.0 系列、Seedance 1.5 pro 支持设置为 -1，表示由模型在有效范围内自主选择合适的视频长度（整数秒）。实际生成视频的时长可通过查询视频生成任务接口返回的 duration 字段获取。注意视频时长与计费相关，请谨慎设置。

frames integer

Seedance 2.0 系列、Seedance 1.5 pro 暂不支持
duration 和 frames 二选一即可，frames 的优先级高于 duration。如果您希望生成小数秒的视频，建议指定 frames。

生成视频的帧数。取值范围：支持 [29, 289] 区间内所有满足 25 + 4n 格式的整数值，其中 n 为正整数。

计算公式：帧数 = 时长 × 帧率（24）。例如：假设需要生成 2.4 秒的视频，帧数 = 2.4 × 24 = 57.6。由于 frames 不支持 57.6，此时选择最接近的满足 25+4n 的值为 57，实际生成的视频为 57/24 = 2.375 秒。

seed integer 默认值 -1

种子整数，用于控制生成内容的随机性。取值范围：[-1, 2^32-1] 之间的整数。

注意：
相同的请求下，模型收到不同的 seed 值（如不指定或令 seed 取值为 -1）将生成不同的结果。
相同的请求下，模型收到相同的 seed 值，会生成类似的结果，但不保证完全一致。

camera_fixed boolean 默认值 false

参考图场景不支持，Seedance 2.0 系列暂不支持

是否固定摄像头。

true：固定摄像头。平台会在用户提示词中追加固定摄像头，实际效果不保证。

false：不固定摄像头。

watermark boolean 默认值 false

生成视频是否包含水印。

false：生成视频不含水印。

true：生成视频右下角会展示 AI 生成 水印。

Content 对象类型

文本信息

字段	类型	必填	说明
`content.type`	string	是	固定为 `"text"`
`content.text`	string	是	输入给模型的文本提示词，描述期望生成的视频

说明：
提示词语言支持：所有模型均支持中英文提示词；Seedance 2.0 及 Seedance 2.0 fast 额外支持日语、印尼语、西班牙语、葡萄牙语。
提示词字数建议：中文提示词不超过 500 字，英文提示词不超过 1000 词。

图片信息

字段	类型	必填	说明
`content.type`	string	是	固定为 `"image_url"`
`content.image_url`	object	是	图片对象
`content.image_url.url`	string	是	图片 URL、图片 Base64 编码（格式：`data:image/<格式>;base64,<编码>`）或素材 ID（格式：`asset://<ASSET_ID>`）
`content.role`	string	条件必填	图片的位置或用途（见下方说明）

role 取值规则：

场景	支持模型	role 取值
图生视频-首帧	全系列	`first_frame` 或不填，传入 1 张图片
图生视频-首尾帧	2.0 系列、1.5 pro、1.0 pro	首帧 `first_frame` + 尾帧 `last_frame`，传入 2 张图片，role 必填
多模态参考-参考图	仅 2.0 系列	`reference_image`，必填，支持 1~9 张

说明：传入的首尾帧图片可相同。首尾帧图片的宽高比不一致时，以首帧图片为主，尾帧图片会自动裁剪适配。

传入单张图片要求：

格式：jpeg、png、webp、bmp、tiff、gif（Seedance 1.5 pro 和 2.0 系列另支持 heic、heif）

宽高比（宽/高）：(0.4, 2.5)

宽高长度（px）：(300, 6000)

大小：单张图片小于 30 MB。请求体大小不超过 64 MB，大文件请勿使用 Base64 编码。

视频信息

仅 Seedance 2.0 系列支持输入视频。

字段	类型	必填	说明
`content.type`	string	是	固定为 `"video_url"`
`content.video_url`	object	是	视频对象
`content.video_url.url`	string	是	视频 URL 或素材 ID（格式：`asset://<ASSET_ID>`）
`content.role`	string	条件必填	当前仅支持 `reference_video`（参考视频）

传入单个视频要求：

视频格式：mp4、mov

支持编码：视频 H.264/AVC、H.265/HEVC；音频 AAC、MP3

分辨率：480p、720p、1080p

时长：单个视频时长 [2, 15] s，最多传入 3 个参考视频，所有视频总时长不超过 15s

尺寸：宽高比 [0.4, 2.5]，宽高长度 [300, 6000] px，总像素数 [409600, 2086876]

大小：单个视频不超过 50 MB

帧率（FPS）：[24, 60]

音频信息

仅 Seedance 2.0 系列支持输入音频。注意不可单独输入音频，应至少包含 1 个参考视频或图片。

字段	类型	必填	说明
`content.type`	string	是	固定为 `"audio_url"`
`content.audio_url`	object	是	音频对象
`content.audio_url.url`	string	是	音频 URL、音频 Base64 编码（格式：`data:audio/<格式>;base64,<编码>`）或素材 ID（格式：`asset://<ASSET_ID>`）
`content.role`	string	条件必填	当前仅支持 `reference_audio`（参考音频）

传入单个音频要求：

格式：wav、mp3

时长：单个音频时长 [2, 15] s，最多传入 3 段参考音频，所有音频总时长不超过 15s

大小：单个音频不超过 15 MB，请求体大小不超过 64 MB，大文件请勿使用 Base64 编码。

样片信息

仅 Seedance 1.5 pro 支持。基于样片任务 ID，生成正式视频。

字段	类型	必填	说明
`content.type`	string	是	固定为 `"draft_task"`
`content.draft_task`	object	是	样片任务对象
`content.draft_task.id`	string	是	样片任务 ID。平台将自动复用 Draft 视频使用的用户输入（model、content.text、content.image_url、generate_audio、seed、ratio、duration、camera_fixed），生成正式视频。

使用分为两步：Step1：调用本接口生成 Draft 视频。Step2：如果确认 Draft 视频符合预期，可基于 Step1 返回的 Draft 视频任务 ID，调用本接口生成最终视频。

不同宽高比对应的宽高像素值

图生视频选择的宽高比与您上传的图片宽高比不一致时，平台会对图片进行居中裁剪。

分辨率	宽高比	宽高像素值（Seedance 1.0 系列）	宽高像素值（Seedance 1.5 pro / 2.0 系列）
480p	16:9	864×480	864×496
	4:3	736×544	752×560
	1:1	640×640	640×640
	3:4	544×736	560×752
	9:16	480×864	496×864
	21:9	960×416	992×432
720p	16:9	1248×704	1280×720
	4:3	1120×832	1112×834
	1:1	960×960	960×960
	3:4	832×1120	834×1112
	9:16	704×1248	720×1280
	21:9	1504×640	1470×630
1080p（Seedance 2.0 fast 不支持）	16:9	1920×1088	1920×1080
	4:3	1664×1248	1664×1248
	1:1	1440×1440	1440×1440
	3:4	1248×1664	1248×1664
	9:16	1088×1920	1080×1920
	21:9	2176×928	2206×946

请求示例

新方式（推荐）：在 request body 中直接传入参数

图生视频-首帧

图生视频-首尾帧

响应参数

id string

视频生成任务 ID。仅保存 7 天（从 created_at 时间戳开始计算），超时后将自动清除。

设置 "draft": true，为 Draft 视频任务 ID。

设置 "draft": false，为正常视频任务 ID。

创建视频生成任务为异步接口，获取 ID 后，需要通过查询视频生成任务接口来查询视频生成任务的状态。任务成功后，会输出生成视频的 video_url。

响应示例

{
  "id": "cgt-20250611100000-xxxxx"
}

后续步骤：拿到 id 后，通过查询接口轮询任务状态，建议轮询间隔不低于 10 秒，直至状态为 succeeded 或 failed。

01-创建视频生成任务

创建视频生成任务#

模型能力#

请求参数#

请求体#

视频输出参数#

Content 对象类型#

文本信息#

图片信息#

视频信息#

音频信息#

样片信息#

不同宽高比对应的宽高像素值#

请求示例#

新方式（推荐）：在 request body 中直接传入参数#

图生视频-首帧#

图生视频-首尾帧#

响应参数#

响应示例#