文档中心

火山方舟

视频生成

视频生成教程

Seedance 模型具备出色的语义理解能力，可根据用户输入的文本、图片、视频、音频等全模态内容，快速生成优质的视频片段。本文为您介绍视频生成模型的通用基础能力，指导您调用 Video Generation API 生成视频。如需了解各版本模型的特色能力，请参见 Doubao Seedance 2.5 教程、Doubao Seedance 2.0 系列教程。

效果预览

访问模型卡片查看更多示例。

场景	输入：提示词	输入：图片、视频、音频	输出
全模态参考可参考图、视频和音频	以图片1为首帧，画面放大至飞机舷窗外，一团团云朵缓缓飘至画面中，其中一朵为彩色糖豆点缀的云朵，始终在画面中居中，然后缓缓变形为图片2中的冰淇淋，镜头推远回到机舱内，坐在窗边的图片3中的角色伸手从窗外拿进冰淇淋，吃了一口，嘴巴上沾满奶油，脸上洋溢出甜蜜的笑容，此时视频配音为音频1	冰淇淋 .mp3	Replay Play 00:00 / 00:08 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag
编辑视频替换视频主体、视频中对象增删改、局部画面重绘/修复等	将视频1中的房子外立面墙壁刷成蓝色，天气和光线参考图片1的雪天	Replay Play 00:00 / 00:08 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag	Replay Play 00:00 / 00:08 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag
延长视频向前或者向后延长视频，或多个视频片段串联成一个连贯视频	将视频1向后延长，11秒视频，汽车丝滑行驶到一片沙漠绿洲，背景音乐使用音频1	Replay Play 00:00 / 00:05 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag 汽车背景音.mp3	Replay Play 00:00 / 00:11 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag
首帧图生视频	镜头围绕人物推镜头拉近，特写人物面部，她正在用京剧唱腔唱“月移花影，疑是玉人来”，唱词充满情感，唱腔充满传统京剧特有的韵味与技巧，完美体现了花旦角色的内心世界		Replay Play 00:00 / 00:05 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag
首尾帧生视频	360度环绕运镜		Replay Play 00:00 / 00:05 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag

新手入门

说明

下文详细介绍使用不同编程语言调用视频生成 API 的示例代码。

若您是编程零基础用户，推荐使用控制台体验中心，包含丰富的模板库，可一键生成同款视频，无需编写代码即可快速上手创作。

若您想快速体验 API 调用，推荐使用API Explorer，内置预设参数模板，可一键发起 API 调用；同时也支持灵活调整参数（例如设置视频水印等），满足多样化的测试和使用场景。

若您想真正开始编程开发，但苦于搭建开发环境、依赖安装等问题，推荐阅读 Seedance 2.5 新手入门或 Seedance 2.0 新手入门。

视频生成是一个异步过程：

成功调用 POST /contents/generations/tasks 接口后，API 将返回一个任务 ID 。

您可以轮询 GET /contents/generations/tasks/{id} 接口，直到任务状态变为 succeeded；或者使用 Webhook 自动接收视频生成任务的状态变化。

任务完成后，您可在 content.video_url 字段处，下载最终生成的 MP4 文件。

说明

方舟平台的新用户？获取 API Key 及开通模型等准备工作，请参见快速入门。

Step1: 创建视频生成任务

通过 POST /contents/generations/tasks 创建视频生成任务。

Curl

Python

Java

请求成功后，系统将返回一个任务 ID。

Step2: 查询视频生成任务

利用创建视频生成任务时返回的 ID ，您可以查询视频生成任务的详细状态与结果。此接口会返回任务的当前状态（如 queued 、running 、 succeeded 等）以及生成的视频相关信息（如视频下载链接、分辨率、时长等）。

说明

因模型、API负载和视频输出规格的不同，视频生成的过程可能耗时较长。为高效管理这一过程，您可以通过轮询 API 接口（详见基础使用和进阶使用部分的 SDK 示例）来请求状态更新，或通过使用 Webhook 通知接收通知。

Curl

Python

Java

当任务状态变为 succeeded 后，您可在 content.video_url 字段处，下载最终生成的视频文件。

模型能力

本表格展示所有 Seedance 模型支持的能力，方便您对比和选型。如需了解各版本模型的特色能力，请参见 Doubao Seedance 2.5 教程、Doubao Seedance 2.0 系列教程。

模型名称		Seedance 2.5	Seedance 2.0	Seedance 2.0 fast	Seedance 2.0 mini	Seedance 1.0 pro	Seedance 1.0 pro fast
Model ID		doubao-seedance-2-5-260628	doubao-seedance-2-0-260128	doubao-seedance-2-0-fast-260128	doubao-seedance-2-0-mini-260615	doubao-seedance-1-0-pro-250528	doubao-seedance-1-0-pro-fast-251015
文生视频		✓	✓	✓	✓	✓	✓
图生视频-首帧		✓	✓	✓	✓	✓	✓
图生视频-首尾帧		✓	✓	✓	✓	✓	✗
全模态参考	图片参考	✓	✓	✓	✓	✗	✗
		视频参考	✓	✓	✓	✓	✗	✗
		音频参考	✓	✗（需搭配图片/视频）	✗（需搭配图片/视频）	✗（需搭配图片/视频）	✗	✗
		组合参考图片 + 音频图片 + 视频视频 + 音频图片 + 视频 + 音频	✓	✓	✓	✓	✗	✗
编辑视频		✓	✓	✓	✓	✗	✗
延长视频		✓	✓	✓	✓	✗	✗
生成有声视频		✓	✓	✓	✓	✗	✗
联网搜索工具		✓	✓	✓	✓	✗	✗
返回视频产物对应的尾帧图		✓	✓	✓	✓	✓	✓
输出视频规格	输出分辨率	480p（8bit 位深） 720p（8bit 位深） 1080p（10bit 位深）	480p（8bit 位深） 720p（8bit 位深） 1080p（8bit 位深） 4k（10bit 位深）	480p（8bit 位深） 720p（8bit 位深）	480p（8bit 位深） 720p（8bit 位深）	480p 720p 1080p	480p 720p 1080p
	输出宽高比	21:9 16:9 4:3 1:1 3:4 9:16	21:9 16:9 4:3 1:1 3:4 9:16	21:9 16:9 4:3 1:1 3:4 9:16	21:9 16:9 4:3 1:1 3:4 9:16	21:9 16:9 4:3 1:1 3:4 9:16	21:9 16:9 4:3 1:1 3:4 9:16
	输出帧率	24 fps	24 fps	24 fps	24 fps	24 fps	24 fps
	输出时长	4~30 秒	4~15 秒	4~15 秒	4~15 秒	2~12 秒	2~12 秒
	输出视频格式	mp4	mp4	mp4	mp4	mp4	mp4
离线推理		✗	✗	✗	✗	✓	✓

基础使用

文生视频

根据用户输入的提示词生成视频，结果具有较大的随机性，可以用于激发创作灵感。

提示词	输出
写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，镜头逐渐拉近，最终定格在一朵雏菊花的特写上，花瓣上有几颗晶莹的露珠	Replay Play 00:00 / 00:05 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag

Python

Java

图生视频-基于首帧（含音频）

通过指定视频的首帧图片，模型能够基于该图片生成与之相关且画面连贯的视频内容。

提示词	首帧	输出
女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动，可以听到风声		Replay Play 00:00 / 00:05 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag

Python

Java

图生视频-基于首尾帧（含音频）

通过指定视频的起始和结束图片，模型即可生成流畅衔接首、尾帧的视频，实现画面间自然、连贯的过渡效果。

提示词	首帧	尾帧	输出
图中女孩对着镜头说“茄子”，360度环绕运镜			Replay Play 00:00 / 00:05 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag

Python

Java

管理视频任务

查询视频生成任务列表

该接口支持传入条件筛选参数，以查询符合条件的视频生成任务列表。

Curl

Python

Java

删除或取消视频生成任务

取消排队中的视频生成任务，或者删除视频生成任务记录。

Curl

Python

Java

自定义视频输出规格

通过 API 参数控制输出视频的规格，包括分辨率、宽高比、时长、是否包含水印等。

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

此方式为强校验，若参数填写错误，模型会返回错误提示。

旧方式：在文本提示词后追加 --[parameters]

此方式为弱校验，若参数填写错误，该参数将被忽略或触发报错。

分辨率和宽高比

通过以下参数控制输出视频的分辨率和宽高比，分辨率和宽高比将共同决定输出视频的像素尺寸。

resolution：指定输出视频的分辨率，支持 480p，720p，1080p，4k。

ratio：指定输出视频的宽高比，支持 16:9，4:3，1:1，3:4，9:16，21:9，adaptive。

说明

Seedance 2.5 在视频编辑、视频延长、首帧/首尾帧生视频任务下，ratio 仅支持 adaptive（自动保持与输入视频一致的宽高比），不支持自行设置具体宽高比。详见配置方法。

各模型输出视频的像素尺寸如下：

分辨率	宽高比	Seedance 2.5	Seedance 2.0 系列	Seedance 1.0 系列
480p	16:9	854×480	864×496	864×480
		4:3	752×560	752×560	736×544
		1:1	640×640	640×640	640×640
		3:4	560×752	560×752	544×736
		9:16	480×854	496×864	480×864
		21:9	992×432	992×432	960×416
720p	16:9	1280×720	1280×720	1248×704
		4:3	1112×834	1112×834	1120×832
		1:1	960×960	960×960	960×960
		3:4	834×1112	834×1112	832×1120
		9:16	720×1280	720×1280	704×1248
		21:9	1470×630	1470×630	1504×640
1080p Seedance 2.0 Fast、Seedance 2.0 Mini 暂不支持	16:9	1920×1080	1920×1080	1920×1088
		4:3	1664×1248	1664×1248	1664×1248
		1:1	1440×1440	1440×1440	1440×1440
		3:4	1248×1664	1248×1664	1248×1664
		9:16	1080×1920	1080×1920	1088×1920
		21:9	2206×946	2206×946	2176×928
4k 仅 Seedance 2.0 支持	16:9	—	3840×2160	—
		4:3	—	3326×2494	—
		1:1	—	2880×2880	—
		3:4	—	2494×3326	—
		9:16	—	2160×3840	—
		21:9	—	4398×1886	—

视频时长

通过 duration 参数控制生成视频的时长（整数秒）：

Seedance 1.0 系列: [2, 12]

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

Seedance 2.5: [4,30] 或设置为-1

-1 表示智能指定时长，由模型在有效范围内自主选择合适的视频长度

说明

Seedance 2.5 在视频编辑任务下，duration 仅支持 -1（自动保持与输入视频基本一致的时长），不支持自行设置具体秒数。详见配置方法。

Seedance 1.0 系列模型还支持通过 frames 参数指定生成视频的帧数，从而生成小数秒的视频。

计算公式：帧数 = 时长 × 帧率（24）。

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

注意事项：duration 和 frames 二选一即可，frames 的优先级高于 duration。

视频中添加水印

通过 watermark 参数，来控制是否在生成的视频中添加水印。

true：在视频右下角添加AI生成水印标识。

false：不添加水印。

提示词建议

提示词 = 主体 + 运动，背景 + 运动，镜头 + 运动 ...

用简洁准确的自然语言写出你想要的效果。

如果有较为明确的效果预期，建议先用生图模型生成符合预期的图片，再用图生视频进行视频片段的生成。

文生视频会有较大的结果随机性，可以用于激发创作灵感

图生视频时请尽量上传高清高质量的图片，上传图片的质量对图生视频影响较大。

当生成的视频不符合预期时，建议修改提示词，将抽象描述换成具象描述，并注意删除不重要的部分，将重要内容前置。

更多提示词的使用技巧请参见 Doubao Seedance 2.0 系列提示词指南、Seedance 1.0 系列提示词指南。

进阶使用

离线推理

Seedance 2.5、Seedance 2.0 系列不支持

针对推理时延敏感度低（例如小时级响应）的场景，建议将 service_tier 设为 flex，一键切换至离线推理模式——价格仅为在线推理的 50%，显著降低业务成本。

注意根据业务场景设置合适的超时时间，超过该时间后任务将自动终止。

Python

Java

样片模式

样片（Draft）模式是一种“先预览生成效果，再生成高质量成片”的两步式视频生成方式。开启该功能后，您可以先生成一段低分辨率的预览视频，用于验证其场景结构、镜头调度、主体动作和提示词意图等关键要素；确认结果符合预期后，再使用 Draft 视频任务 ID 生成高质量成片。

视频任务 ID 存在有效期（从 created_at 时间戳开始计算），超时后将自动失效。

Draft 视频任务 ID：2026 年 10 月 28 日 10:00（UTC+8）及之后创建的 Draft 视频任务 ID 有效期为 14 天，此前创建的 Draft 视频任务 ID 有效期仍为 7 天。超出有效期后，无法使用该 Draft 视频生成正式视频。

其他视频任务 ID：有效期均为 7 天。

目前仅 Doubao Seedance 2.5 支持样片模式。参数限制、计费方式和操作步骤参见 Doubao Seedance 2.5 样片模式。

生成多个连续视频

使用前一个生成视频的尾帧，作为后一个视频任务的首帧，循环生成多个连续的视频。

后续您可以自行使用 FFmpeg 等工具，将生成的多个短视频拼接成一个完整长视频。

输出1	输出2	输出3
Replay Play 00:00 / 00:05 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag 女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动 A girl holding a fox, the girl opens her eyes, looks gently at the camera, the fox hugs affectionately, the camera slowly pulls out, the girl's hair is blown by the wind	Replay Play 00:00 / 00:05 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag 女孩和狐狸在草地上奔跑，阳光明媚，女孩的笑容灿烂，狐狸欢快地跳跃 A girl and a fox running on the grass, sunny weather, the girl's smile is brilliant, the fox jumps happily	Replay Play 00:00 / 00:05 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag 女孩和狐狸坐在树下休息，女孩轻轻抚摸狐狸的毛发，狐狸温顺地趴在女孩腿上 A girl and a fox resting under a tree, the girl gently strokes the fox's fur, the fox lies meekly on the girl's lap

使用 Webhook 通知

通过 callback_url 参数可以指定一个回调通知地址，当视频生成任务的状态发生变化时，方舟会向该地址发送一条 POST 请求，方便您及时获取任务最新情况。请求内容结构与查询任务API 的返回体一致。

您需要自行搭建一个公网可访问的 Web Server 来接收 Webhook 通知。以下是一个简单的 Web Server 代码示例，供您参考。

使用限制

全模态输入

注意

Seedance 2.5 和 Seedance 2.0 系列模型不支持直接上传含有真人人脸的参考图/视频。为了便利创作者对肖像的使用，平台推出了一系列解决方案，详情参见便利创作含肖像视频章节。

图片要求

传入方式：图片 URL、图片 Base64 编码、素材 ID。

图片格式：jpeg、png、webp、bmp、tiff、gif。其中，Seedance 2.0 系列及以上模型支持 heic 和 heif。

单个图片尺寸：

宽高比（宽/高）： [0.4, 2.5]

宽高长度（px）：[300, 6000]

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

图片数量：

图生视频-首帧：1 张

图生视频-首尾帧：2 张

seedance 2.5 全模态参考生视频：1~30 张

seedance 2.0 全模态参考生视频：1~9 张

视频要求

传入方式：视频URL、素材 ID。

视频格式：mp4、mov，支持编码格式见下表。

分辨率：480p，720p，1080p，4k

时长：

Seedance 2.5：

非视频编辑任务：单个视频时长 [2, 30] s。

视频编辑任务：单个视频时长 [4, 30] s。

最多传入 10 个参考视频，所有视频总时长不超过 30 s。

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

单个视频尺寸：

宽高比（宽/高）：[0.4, 2.5]

宽高长度（px）：[300, 6000]

总像素数：[614×664=407696, 3326×2494=8295044]，即宽和高的乘积符合 [407696, 8295044] 的区间要求。

大小：单个视频不超过 200 MB。

帧率 (FPS)：[24, 60]

容器格式	常用文件扩展名	MIME	支持编码
MP4	.mp4	video/mp4	视频：H.264/AVC、H.265/HEVC 音频：AAC、MP3
QuickTime	.mov	video/quicktime	视频：H.264/AVC、H.265/HEVC 音频：AAC、MP3

音频要求

传入方式：音频 URL 、音频 Base64 编码、素材 ID。

音频格式：wav、mp3

时长：

Seedance 2.5：单个音频时长 [2, 30] s，最多传入 10 段参考音频，所有音频总时长不超过 30 s。

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

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

保存时间

视频任务 ID 存在有效期（从 created_at 时间戳开始计算），超时后将自动失效。

Draft 视频任务 ID：2026 年 10 月 28 日 10:00（UTC+8）及之后创建的 Draft 视频任务 ID 有效期为 14 天，此前创建的 Draft 视频任务 ID 有效期仍为 7 天。

其他视频任务 ID：有效期均为 7 天。

视频 URL：保存 24 小时（超时后无法访问），下载次数上限为 100 次，请及时下载或转存。

限流说明

同一主账号下，使用同一模型（不区分版本）的请求受到以下限制。超过对应限制会返回 “429: 'Too Many Requests'” 错误。

模型维度的限流

在线推理

不同模型的 RPM 和最大并发任务数不同，详见视频生成能力。

RPM（Requests Per Minute）：每分钟允许创建的视频生成任务数上限。超过上限时，创建任务请求将因触发限流而失败。

最大并发任务数：同一时刻可处于处理状态的任务数上限。达到上限后，新创建的任务将进入队列等待处理。

离线推理

不同模型的 TPD 限流值不同，详见视频生成能力。

TPD（Tokens Per Day）：每天可以处理的 token 量限制。

非推理 API 请求频率限制

QPS（Queries Per Second）：每秒允许的请求数上限。超过上限时，任务请求将因触发限流而失败。

接口名称	账号维度的 QPS 上限
查询视频生成任务	20
查询视频生成任务列表	1
取消或删除视频生成任务	20

图片裁剪规则

seedance 系列模型的图生视频场景，支持设置生成视频的宽高比。当选择的视频宽高与您上传的图片宽高比不一致时，方舟会对您的图片进行裁剪，裁剪时会居中裁剪。详细规则如下：

说明

若要呈现出较好的视频效果，建议所指定的视频宽高比（ratio）与实际上传图片的宽高比尽可能接近。

输入参数：

原始图片宽度记为W（单位：像素），高度记为H（单位：像素）。

目标比例记为A:B（例如，21:9），这表示裁剪后的宽度与高度之比应为 A/B（如 21/9≈2.333）。

比较宽高比：

计算原始图片的宽高比Ratio_原始=W/H。

计算目标比例的比值Ratio_目标=A/B（例如，21:9 的 Ratio目标=21/9≈2.333)。

根据比较结果，决定裁剪基准：

如果Ratio_原始<Ratio_目标（即原始图片“太高”或“竖高”），则以宽度为基准裁剪。

如果Ratio_原始>Ratio_目标（即原始图片“太宽”或“横宽”），则以高度为基准裁剪。

如果相等，则无需裁剪，直接使用全图。

裁剪尺寸计算（量化公式）：

以宽度为基准（适用于竖高图片）：

裁剪宽度Crop_W=W（使用整个原始宽度）。

裁剪高度Crop_H=(B/A)×W（根据目标比例等比例计算高度）。

裁剪区域的起始坐标（居中定位）：

X 坐标（水平）：总是 0（因为宽度全用，从左侧开始）。

Y 坐标（垂直）：(H−Crop_H)/2（确保垂直居中，从顶部开始）。

以高度为基准（适用于横宽图片）：

裁剪高度Crop_H=H（使用整个原始高度）。

裁剪宽度Crop_W=(A/B)×H（根据目标比例等比例计算宽度）。

裁剪区域的起始坐标（居中定位）：

X 坐标（水平）：(W−Crop_W)/2（确保水平居中，从左侧开始）。

Y 坐标（垂直）：总是 0（因为高度全用，从顶部开始）。

裁剪结果：

最终裁剪出的图片尺寸为Crop_W×Crop_H，比例严格为A:B，且完全位于原始图片内部，无黑边。

裁剪区域总是以原始图片中心为基准，因此内容居中。

裁剪示例：

以 seedance 1.0 Pro 首帧图生视频功能为例

输入的首帧图片	指定的宽高比ratio	生成的视频结果
16:9	21:9	Replay Play 00:00 / 00:05 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag
		16:9	Replay Play 00:00 / 00:05 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag
		4:3	Replay Play 00:00 / 00:05 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag
		1:1	Replay Play 00:00 / 00:05 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag
		3:4	Replay Play 00:00 / 00:05 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag
		9:16	Replay Play 00:00 / 00:05 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag

最近更新时间：2026.10.28 10:00:16

这个页面对您有帮助吗？

有用

无用