文档中心

火山方舟

视频生成

Doubao Seedance 2.5 教程

Doubao Seedance 2.5（下文简称 Seedance 2.5）是新一代视频创作模型，在长叙事能力、全模态参考能力和编辑能力上全面提升。单次生成时长提升至 30 秒并支持多轮延长，单次参考多模态素材上限提升至 50 个，提供基于时间戳的精准编辑控制。画面质感全面优化，成片更接近实拍的影视质感。本文介绍 Seedance 2.5 模型的特色能力与使用方法，帮助您快速实现创建视频生成任务 API 调用。

模型开通条件

开通 Seedance 2.5 模型前，请确保您满足以下任一条件：

【推荐】账户余额 > 200 元（前往充值）

【推荐】购买 200 元档位及以上专属节省计划，购买入口：购买节省计划。

已购买 Seedance 2.5 系列资源包且有可用余量（前往购买）

详细规则见 Seedance 2.5 与 Seedance 2.0 系列模型开通、使用与退订说明。

使用前必读

警告

Seedance 2.5 模型在视频编辑、首帧/首尾帧、视频延长任务下存在特殊限制，如不遵循将触发报错。

请务必在调用模型前仔细阅读下文，确保任务类型、提示词意图和参数配置一致。

任务类型与限制

Seedance 2.5 会根据输入素材和提示词意图判断任务类型。任务类型包括文生视频、首帧/首尾帧生视频，以及全模态参考生视频任务；其中全模态参考生视频任务根据提示词意图进一步分为参考生视频、视频编辑和视频延长 3 类子任务。

任务类型			触发条件	特殊限制
文生视频			仅传入文本提示词	ratio / duration 无特殊限制
首帧/首尾帧生视频			content.role 设置为 first_frame / last_frame	ratio 必须为 adaptive 模型自动保持输出视频宽高比和 `first_frame` 指定的首帧图片一致
全模态生视频任务	参考生视频	content 中至少包含一个 role 为 reference_image、reference_video 或 reference_audio 的参考素材	ratio / duration 无特殊限制
		视频编辑	content 中至少包含一个 role 为 reference_video 的参考视频，并通过提示词表达编辑意图	ratio 必须为 adaptive、duration 必须为 -1 模型根据提示词意图选定待编辑视频，并自动保持输出视频宽高比、时长和待编辑视频一致 * 参考视频时长必须为 4-30 秒
		视频延长	content 中至少包含一个 role 为 reference_video 的参考视频，并通过提示词表达延长意图	ratio 必须为 adaptive 模型根据提示词意图选定待延长视频，并自动保持输出视频宽高比和待延长视频一致

注意

为减少因特殊限制触发的异步报错，全模态参考生视频任务可通过配置omni_reference_task_type显示引导任务类型将报错前置，具体参考下文配置方法。

配置方法

全模态参考生视频（不区分子任务）

对于全模态参考生视频任务，如果您没有明确区分具体的子任务类型，推荐按以下方式配置参数：

omni_reference_task_type 设置为 auto。

content.role 设置为 reference_image、reference_video 或 reference_audio。

推荐将 ratio 设置为 adaptive、duration 设置为 -1。如果传入参考视频，建议单个参考视频时长为 4–30 秒。

说明

omni_reference_task_type 设置为 auto 时，模型根据提示词意图，可能将任务判定为参考生视频、视频编辑、视频延长任务。其中视频编辑、视频延长任务对配置参数有特殊限制。按推荐方式配置，可以兼容这些限制，减少任务创建后触发异步报错。

视频编辑

对原视频的画面或音频进行编辑操作，如替换视频主体、增删视频中对象、局部画面重绘或修复等

对于明确的视频编辑类任务，推荐以下配置方法:

omni_reference_task_type 设置为 edit。

content 中至少包含一个 role 为 reference_video 的参考视频。

ratio 必须为 adaptive；duration 必须为 -1；参考视频时长必须为 4–30 秒。

提示词中需包含至少一个关键词：编辑视频、增加/加上、删除/去掉、修改/替换/改成。

提示词示例：@video1 中加一些小动物；把 @video1 的人物修改为 @image1；删掉 @video1 的背景音乐

视频延长

对原视频进行向前或向后延长

对于明确的视频延长类任务，推荐以下配置方法:

omni_reference_task_type 设置为 extend。

content 中至少包含一个 role 为 reference_video 的参考视频。

ratio 必须为 adaptive。

提示词中需包含至少一个关键词：向前/向后延长、延续、续写。

提示词示例：向后延长 @video1，@image1 的角色从天而降...；续写 @video1 前 5s，@video2 女人入画说...

首帧/首尾帧生视频

输入 1 张图作为首帧生成视频，或输入 2 张图分别作为首帧和尾帧生成视频

content 中需包含 role 为 first_frame 的图片；首尾帧生视频还需包含 role 为 last_frame 的图片。

ratio 必须为 adaptive。

报错机制

Seedance 2.5 存在以下两种参数校验与报错机制。

同步报错（提交任务时）

对于全模态参考生视频任务，显式指定 omni_reference_task_type 为 edit 或 extend 时，接口将前置校验特殊参数限制，若不符合要求，接口立即返回错误。

注意

实际处理任务时，模型仍会进一步结合提示词判断任务类型。若实际判定的任务类型和指定的不一致，仍会触发异步报错（错误码： InvalidParameter.TaskTypeMismatch）。建议遵循各任务类型提示词写法，降低报错概率。

异步报错（任务启动后）

对于全模态参考生视频任务，未传入 omni_reference_task_type 或将其设置为 auto 时，模型先根据输入素材和提示词判断实际任务类型，再校验该类型的特殊参数限制。不符合要求时，任务异步报错。

对于首帧/首尾帧生视频，参数配置不符合任务特殊限制时，任务异步报错

说明

因参数配置和任务类型不兼容导致的异步报错，错误码：InvalidParameter.TaskTypeConstraint。

新手入门

说明

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

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

若您想真正开始编程开发，但苦于搭建开发环境、依赖安装等问题，推荐阅读本节内容。

本入门教程专为 API 新手用户设计，帮助您一键搭建 Python 开发环境、完成虚拟环境创建和方舟 SDK 安装，并提供直接可运行的 Seedance 2.5 调用代码，您只需修改对应的输入素材，即可开始您的视频生成创作。

1. 准备工作

在开始之前，请确保您已经完成以下准备：

注册账号：确保您拥有火山引擎账号并已登录。

获取 API Key：访问 API Key 管理页面，点击创建 API Key，并复制保存您的 API Key。注意请妥善保管您的 API Key，不要泄露给他人。

开通模型：请确保您的账户余额大于等于 200 元，或已购买资源包，否则无法开通 Seedance 2.5 模型。

下载并解压文件：点击下载下方附件，将其解压到您的本地目录（如桌面或“下载”文件夹）。

ark_seedance2.5_quickstart_package.zip

2.操作步骤

Windows 用户

macOS 用户

进入 scripts/init_dev_env 目录。

双击运行 setup_windows.bat。

脚本会自动执行以下操作：

下载 uv 工具。

自动下载 Python 3.12（如果不干扰您的系统 Python）。

创建虚拟环境 .venv。

安装方舟 SDK。

完成后，在项目根目录会生成一个 run_demo.bat。

双击 run_demo.bat，即可运行 Python SDK 示例代码(python/demo_standard.py)。

3.运行说明

运行脚本后，您将看到如下流程：

API Key 校验：脚本会自动检测您本地是否配置了ARK_API_KEY环境变量。如果没有，会提示您手动输入。

素材预览：脚本会自动在您的默认浏览器中弹出一个本地生成的 HTML 页面，直观地展示本次任务的文本提示词、待替换的参考图片以及原始参考视频。

任务创建与轮询：脚本向火山方舟服务器发起异步请求。由于视频生成需要一定时间，控制台会每隔 30 秒打印一次任务状态（如 running等）。

获取结果：任务成功后，控制台会输出一段最终生成的视频 URL。您可以复制该链接到浏览器下载或在线播放。

4.下一步

在成功跑通本示例后，您可以尝试修改 python/``demo_standard.py，来打造您专属的视频生成任务：

修改文本提示词

找到代码中的 user_content 变量，更改为您想要的画面描述。

2. 替换输入素材 (图片、视频、音频)

您可以将 reference_image_url、reference_video_url 和 reference_audio_url 替换为您自己的素材链接。

注意：请确保 URL 是公网可公开访问的链接（建议存放在 TOS 对象存储服务中，并配置为公共读。详细介绍请参见 TOS 数据订阅）。

3. 继续学习下文中丰富的使用示例。

最新能力

生成视频时长翻倍

生成视频时长上限由 15 秒延长至 30 秒。

参考素材数量增加

参考图数量上限由 9 张增至 30 张，

参考音/视频数量上限由 3 个增至 10 个

参考音/视频总时长由 15 秒增至 30 秒

更智能的宽高比/时长控制

视频编辑任务，自动保持输出视频的宽高比、时长和输入视频一致。

视频延长、首帧/首尾帧任务，自动保持输出视频的宽高比和输入视频一致。

新增 mov 输出格式

输出视频新增 mov 格式（H.264 视频编码 + yuv444p 色度采样 + PCM 音频编码），提升视频编辑和视频延长场景下的色彩保真度与声画一致性。

原生多语言

支持中文、英语、西班牙语、印度尼西亚语、马来语、泰语、阿拉伯语、葡萄牙语、越南语、日语、韩语等 11 种语言。

能力概述

模型名称		Seedance 2.5	Seedance 2.0	Seedance 2.0 fast	Seedance 2.0 mini
Model ID		doubao-seedance-2-5-260628	doubao-seedance-2-0-260128	doubao-seedance-2-0-fast-260128	doubao-seedance-2-0-mini-260615
文生视频		✓	✓	✓	✓
首帧生视频		✓	✓	✓	✓
首尾帧生视频		✓	✓	✓	✓
全模态参考	图片参考	✓	✓	✓	✓
		视频参考	✓	✓	✓	✓
		音频参考	✓	✗（需搭配图片/视频）	✗（需搭配图片/视频）	✗（需搭配图片/视频）
		组合参考图片 + 音频图片 + 视频视频 + 音频图片 + 视频 + 音频	✓	✓	✓	✓
编辑视频		✓	✓	✓	✓
延长视频		✓	✓	✓	✓
生成有声视频		✓	✓	✓	✓
参考素材数量上限		50（30张图+10个视频+10个音频）	15（9张图+3个视频+3个音频）	15（9张图+3个视频+3个音频）	15（9张图+3个视频+3个音频）
联网搜索工具		✓	✓	✓	✓
样片模式		✓	✗	✗	✗
返回尾帧		✓	✓	✓	✓
输出视频规格	输出分辨率	480p（8bit 位深） 720p（8bit 位深） 1080p（10bit 位深）	480p（8bit 位深） 720p（8bit 位深） 1080p（8bit 位深） 4k（10bit 位深）	480p（8bit 位深） 720p（8bit 位深）	480p（8bit 位深） 720p（8bit 位深）
		输出宽高比	21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive	21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive	21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive	21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive
		输出时长	4~30 秒；-1（在有效时长内由模型自动选择最佳时长）	4~15 秒；-1（在有效时长内由模型自动选择最佳时长）	4~15 秒；-1（在有效时长内由模型自动选择最佳时长）	4~15 秒；-1（在有效时长内由模型自动选择最佳时长）
		输出视频格式	mp4, mov	mp4	mp4	mp4
离线推理		✗	✗	✗	✗

特色能力

30 秒视频连贯直出

Seedance 2.5 视频生成时长上限由 Seedance 2.0 系列的 15 秒延长至 30 秒，支持一次性生成长达 30 秒的连贯视频，无需多段拼接即可呈现完整故事。

输入：文本 + 8 张图片	输出
提示词：一镜到底，镜头平稳跟随一个穿黑色大衣的人从左向右穿过六个相连的不同色调、不同氛围的房间...（详见下方代码示例中的完整提示词）	Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag

Curl

Python

Java

50 个全模态参考素材输入

Seedance 2.5 单次输入素材上限提升至 50 个（30 张图片 + 10 段视频 + 10 段音频），可自由组合图片、视频、音频等多模态素材，实现更丰富的创意表达。同时，Seedance 2.5 新增支持纯音频参考生成视频，无需搭配图片或视频素材。

输入：文本 + 1 张图片 + 6 段视频					输出
提示词：明亮多彩的广告片风格，果味饼干为主角...（详见下方代码示例中的完整提示词）	Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag	Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag	Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag

Curl

Python

Java

更智能的时长和宽高比控制

Seedance 2.5 模型支持通过配置ratio 为 adaptive、duration 为 -1以智能控制输出视频的宽高比和时长；但在视频编辑、视频延长、首帧或首尾帧生视频任务中，具有特殊的控制行为，详情参考以下示例。

使用示例-视频编辑

在视频编辑任务中，Seedance 2.5 会根据提示词意图选定待编辑视频，并自动保持输出视频宽高比、时长和待编辑视频一致（参数 ratio 默认且仅支持配置为 adaptive，参数 duration 默认且仅支持配置为 -1，均不支持另行设置）。

注意

受输入帧处理影响，输出时长可能略短于输入视频（误差不超过 0.4 秒）。

输入：文本 + 视频（宽高比 5:4，时长 16 秒）	输出（宽高比 5:4，时长 16 秒）
Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag 提示词：视频编辑：删除 @视频1中的所有人，除了主角。	Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag 输出视频宽高比自动和待编辑视频的 5:4 保持一致；输出视频时长和待编辑视频的 16 秒基本一致

Curl

Python

Java

使用示例-视频延长

在视频延长任务中，Seedance 2.5 会根据提示词意图选定待延长视频，并自动保持输出视频宽高比和待延长视频一致（参数 ratio 默认且仅支持配置为 adaptive）。视频输出时长可以自行设置或由模型智能判断（参数 duration 支持配置为 [4, 30] 或 -1）。

输入：文本 + 视频（视频1宽高比 7:5，视频2、视频3宽高比 16:9）			输出（宽高比 7:5）
Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag 提示词：延长@视频1，窗户打开后进入@视频2的美术馆室内，最后镜头进入@视频3的画内	Replay Play 00:00 / 00:03 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag	Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag 输出视频宽高比自动和待延长视频的 7:5 保持一致

Curl

Python

Java

使用示例-首帧/首尾帧生视频

在首帧/首尾帧生视频任务中，Seedance 2.5 会自动保持输出视频宽高比和 first_frame 指定的首帧图片一致（参数 ratio 默认且仅支持配置为 adaptive）。视频输出时长可以自行设置或由模型智能判断（参数 duration 支持配置为 [4, 30] 或 -1）。

输入：文本 + 首帧（宽高比 1:1） + 尾帧			输出（宽高比 1:1）
提示词：图中女孩对着镜头说“茄子”，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 输出视频宽高比自动和首帧图片的 1:1 保持一致

Curl

Python

Java

原生多语言生成

Seedance 2.5 原生支持多种语言的提示词输入和有声视频生成，覆盖支持中文、英语、西班牙语、印度尼西亚语、马来语、泰语、阿拉伯语、葡萄牙语、越南语、日语、韩语。

输入：文本 + 图片	输出
提示词：电影级 hip-hop / 说唱音乐视频，歌词覆盖 8 种语言...（详见下方代码示例中的完整提示词）	Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag

Curl

Python

Java

更多能力

Seedance 2.5 同样支持以下基础能力，详细使用方式和代码示例请参考对应链接：

文生视频：输入文本提示词生成一段视频。

使用联网搜索：根据提示词自主判断是否搜索互联网内容（如商品、天气等）。提升生成视频的时效性。

样片模式：先生成 480p Draft 视频验证效果，再基于 Draft 视频生成高质量成片。

样片模式

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

Draft 视频任务 ID 有效期

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

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

输入	Draft 视频	正式视频
提示词：女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动，可以听到风声	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 生成一段 Draft 视频，预览并确认生成效果。	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 复用 Draft 视频使用的模型、提示词、输入素材、种子值、音频设置、视频宽高比、视频时长等关键参数生成正式视频，保证视频关键要素一致。

Step1:生成 Draft 视频

在调用 POST /contents/generations/tasks 接口创建生视频任务时，通过配置 draft=true，即可开启 Draft 模式。

注意

仅支持生成 480p 分辨率的 Draft 视频，设置其他分辨率将触发报错。

生成 480p Draft 视频的 token 用量和单价，均与正常生成 480p 视频一致。

Draft 视频任务 ID 存在有效期（从 created_at 时间戳开始计算），超时后将自动失效。2026 年 10 月 28 日 10:00（UTC+8）及之后创建的 Draft 视频任务 ID 有效期为 14 天，此前创建的 Draft 视频任务 ID 有效期仍为 7 天。超出有效期后，无法使用该 Draft 视频生成正式视频。

Curl

创建 Draft 视频生成任务。

请求成功后，系统将返回一个任务 ID。此 ID 即为 Draft 视频任务 ID，后续需基于这个 ID 生成最终视频。

curl https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY" \
-d '{
"model": "doubao-seedance-2-5-260628",
"content": [
{
"type": "text",
"text": "女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，镜头缓缓拉远"
},
{
"type": "image_url",
"image_url": {
"url": "https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/i2v_foxrgirl.png"
}
}
],
"duration": 5,
"ratio": "adaptive",
"resolution": "480p",
"output_format": "mov",
"service_tier": "default",
"draft": true,
"watermark": true
}'

使用 Draft 视频任务 ID，查询生成状态和结果。

当任务状态变为 succeeded 后，可在 content.video_url 字段处下载生成的 Draft 视频文件。确认 Draft 视频效果符合预期后，即可按照后续步骤生成最终视频。

curl "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/<DRAFT_TASK_ID>" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY"

Step2:生成正式视频

如果确认 Draft 视频符合预期，可基于 Step1 返回的 Draft 视频任务 ID，再次调用 POST /contents/generations/tasks 接口，生成最终视频。

注意

基于 Draft 视频生成正式视频时，当前仅支持生成 1080p 分辨率的视频，设置其他分辨率将触发报错。

Draft 视频任务 ID 存在有效期（从 created_at 时间戳开始计算），超时后将自动失效。2026 年 10 月 28 日 10:00（UTC+8）及之后创建的 Draft 视频任务 ID 有效期为 14 天，此前创建的 Draft 视频任务 ID 有效期仍为 7 天。超出有效期后，无法使用该 Draft 视频生成正式视频。

Step 1 和 Step 2 两类任务独立计费：

Step 1：生成 Draft 视频，按 480p 视频计费。

Step 2：基于 Draft 生成正式视频，按目标分辨率计费：

token 单价根据 Step 1 是否包含输入视频确定。

计算 token 用量时，输入视频时长按 Step 1 的输入视频计算，Draft 视频不计入。

基于 Draft 视频生成正式视频时，不同参数的处理方式不同：部分需固定传入，部分由模型自动复用，部分可按成片需求重新设置。请按下表规则配置参数，避免请求报错。

类型	参数	规则
取值固定参数	模型 ID（model）样片模式（draft）分辨率（resolution）	model 必须与创建 Draft 任务时使用的一致。 draft 可不传入或设置为 false。 resolution 必须传入，仅支持设置为 1080p。
自动复用参数	提示词（content.text）参考图片/视频/音频（content.image_url、content.video_url、content.audio_url）时长（duration）宽高比（ratio）随机种子数（seed）是否生成有声视频（generate_audio）任务类型（omni_reference_task_type）	模型自动复用创建 Draft 任务时使用的参数取值。禁止传入。即使传入值与 Draft 阶段使用的一致，也会触发报错。
可重新指定参数	返回尾帧（return_last_frame）输出格式（output_format）水印（watermark）服务等级（service_tier）任务超时阈值（execution_expires_after）执行优先级（priority）回调地址（callback_url）用户标识（safety_identifier）	不传入时，自动使用模型默认值，不会沿用 Draft 视频的实际取值。参数取值需满足 Seedance 2.5 模型对应的限制，详见创建视频生成任务 API。

Curl

基于 content.draft_task.id 创建视频生成任务。

curl https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY" \
-d '{
"model": "doubao-seedance-2-5-260628",
"content": [
{
"type": "draft_task",
"draft_task": {
"id": "<DRAFT_TASK_ID>"
}
}
],
"resolution": "1080p",
"output_format": "mov",
"watermark": true
}'

使用视频任务 ID，查询生成状态和结果。

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

curl "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/<TASK_ID>" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY"

自定义视频输出规格

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

resolution：指定输出视频的分辨率。

ratio：指定输出视频的宽高比。

duration：指定输出视频的时长。

output_format：指定输出视频的格式。

watermark：指定是否为输出视频添加水印。

分辨率

通过 resolution 参数指定输出视频的分辨率。

默认值：720p

可选值：

480p（8bit 位深）

720p（8bit 位深）

1080p（10bit 位深）

说明

Seedance 2.5 输出的 1080p 视频采用 10bit 位深与 H.265/HEVC 编码。

相较于一般的 8bit 位深，10bit 位深能够保留更丰富的色彩层次与更平滑的渐变过渡，满足专业影视制作与 HDR 视频内容的要求。

H.265/HEVC 编码在少数播放环境中可能不兼容。如遇问题，建议升级系统、更换设备，或使用 VLC、MPV、QuickTime Player 等播放器查看。

宽高比

通过 ratio 参数指定输出视频的宽高比。

默认值：adaptive：即模型根据输入的提示词和参考素材，自动适配视频宽高比。

可选值：16:9、4:3、1:1、3:4、9:16、21:9、adaptive

adaptive 适配规则

视频编辑 / 视频延长：模型根据提示词意图选定待编辑视频或待延长视频，并自动保持输出视频宽高比和待编辑视频或待延长视频一致。

首帧 / 首尾帧生视频：保持输出视频宽高比和 first_frame 指定的首帧图片一致。

文生视频/参考生视频：根据提示词选择可选宽高比中（16:9、4:3、1:1、3:4、9:16、21:9）最合适的宽高比。

注意

Seedance 2.5 在视频编辑、视频延长、首帧 / 首尾帧生视频任务中，仅支持配置 ratio 为 adaptive，不可指定具体宽高比。

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

分辨率	宽高比	像素尺寸（宽×高）
480p	16:9	854×480
		4:3	752×560
		1:1	640×640
		3:4	560×752
		9:16	480×854
		21:9	992×432
720p	16:9	1280×720
		4:3	1112×834
		1:1	960×960
		3:4	834×1112
		9:16	720×1280
		21:9	1470×630
1080p	16:9	1920×1080
		4:3	1664×1248
		1:1	1440×1440
		3:4	1248×1664
		9:16	1080×1920
		21:9	2206×946

视频时长

通过 duration 参数指定生成视频的时长（单位：秒）。

默认值：-1：即模型根据输入的提示词和参考素材，自动适配视频时长。

取值范围：[4, 30] 或 -1

duration = -1 适配规则

视频编辑任务：模型根据提示词意图选定待编辑视频，并自动保持输出视频时长和待编辑视频基本一致。

输出视频可能是非整数秒

输出视频可能略短于待编辑视频，误差不超过 0.4 秒

其他生视频任务：模型在 [4, 30] 范围内，自主选择合适的视频长度（整数秒）。

注意

Seedance 2.5 在视频编辑任务仅支持配置 duration 为 -1，不可指定具体时长；且传入的待编辑视频时长需在 [4, 30]s 内，否则将触发报错。

输出格式

通过 output_format 参数控制输出视频的格式。

mp4（默认）：通用格式，兼容性最好，采用标准色彩精度可在网页、移动端、各类播放器及分发平台直接播放。

mov：面向专业场景的高色彩精度格式，更好地保持画面色彩与亮度一致性、适用于调色、抠像、合成等对色彩还原要求高的专业后期加工。推荐在视频编辑和视频延长场景使用 mov 格式作为输入和输出。

mov 格式播放兼容性

mov 格式采用专业编码（H.264视频编码+yuv444p 色度采样+PCM 音频编码），部分播放器可能不兼容。以下为常见的支持播放 mov 格式的播放器：

播放器	macOS	Windows
IINA	✓	✕
VLC	✓	✓
mpv	✓	✓
ffplay	✓	✓

视频中添加水印

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

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

false（默认）：不添加水印。

便利创作含肖像视频

Seedance 2.5 支持与 Seedance 2.0 系列相同的便利创作功能，详细教程请参见 Doubao Seedance 便利创作含肖像视频：

方案	介绍
信任模型产物作为输入素材	本账号下部分模型生成的含人脸原始产物可作为输入素材，再次调用 Seedance 2.5 系列模型进行二次创作，不会触发输入审核拦截。
使用预置虚拟人像	平台预置虚拟人像库，为创作者提供免费、合规、丰富多样的肖像素材。适用于需真人风格人脸但无需指定具体人物，追求零合规风险、快速创作的场景。
使用已授权真人素材	支持使用已获得授权的真人肖像素材进行视频生成。

提示词技巧

提示词 Skill

平台提供 Seedance 2.5 提示词优化技能，方便您对提示词进行调优。

在本地项目中通过 NPX 安装：

使用方式：在 AI 对话框输入 /sd25-pe + 你的提示词内容，开始调试提示词。

提示词规则

遵循基础公式：按照"主体 + 动作/事件 + 场景与环境 + 视觉风格 + 运镜/切镜 + 声音"的顺序组织提示词，不需要的部分可省略。

明确素材职责：使用 @图片1、@视频1、@音频1 指代参考素材，说明每份素材具体提供什么（如外貌、动作、音色），以及不采用什么。

声音用特殊字符区分：音乐用 ()、音效用 <>、台词用 {}、字幕用【】。非中文台词建议在台词前明确语言。

完整的提示词撰写方法、模板和进阶技法详见 Seedance 2.5 提示词指南。

使用限制

全模态输入

注意

Seedance 2.5 不支持直接上传含有真人人脸的参考图/视频。

为了便利创作者对肖像的使用，平台推出了一系列解决方案，详情参见 Doubao Seedance 便利创作含肖像视频。

图片要求

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

图片格式：jpeg、png、webp、bmp、tiff、gif、heic、heif。

单个图片尺寸：

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

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

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

图片数量：

图生视频-首帧：1 张

图生视频-首尾帧：2 张

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

视频要求

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

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

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

时长：

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

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

最多传入 10 个参考视频，所有视频总时长不超过 30 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、PCM

音频要求

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

音频格式：wav、mp3

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

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

保存时间

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

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

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

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

限流说明

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

模型维度的限流

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

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

限流维度	企业用户	个人用户
最大 RPM	600	180
最大并发数	10	3

非推理 API 请求频率限制

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

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

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

这个页面对您有帮助吗？

有用

无用