视频生成 Doubao Seedance 2.5 教程 Doubao Seedance 2.5（下文简称 Seedance 2.5）是新一代视频创作模型，在长叙事能力、多模态参考能力和编辑能力上全面提升。单次生成时长提升至 30 秒并支持多轮延长，单次参考多模态素材上限提升至 50 个，提供基于时间戳的精准编辑控制。画面质感全面优化，成片更接近实拍的影视质感。本文介绍 Seedance 2.5 模型的特色能力与使用方法，帮助您快速实现 创建视频生成任务 API 调用。 说明 开通 Seedance 2.5 模型前，请确保您满足以下任一条件： 账户余额 > 200 元（前往充值） 已购买 Seedance 2.5 系列资源包且有可用余量 （前往购买） 详细规则见 Seedance 2.0-2.5 模型资源包使用规则。 使用前必读 警告 Seedance 2.5 模型在视频编辑、首帧/首尾帧、视频延长任务下存在特殊限制，如不遵循将触发 异步报错。 请务必在调用模型前仔细阅读下文，确保正确设置任务类型和配置参数。 各任务限制说明 Seedance 2.5 会根据参数 content.role 取值和提示词意图，将请求判定为 文生视频、参考生视频、视频编辑、视频延长、首帧/首尾帧生视频这5种任务类型 。 若任务类型为 视频编辑、视频延长、首帧/首尾帧生视频 ，模型对宽高比和时长参数有特殊限制， 违反限制将触发异步报错 。请对照下方各任务的触发条件和特殊限制来设置参数。 若任务类型为 文生视频、参考生视频 ，模型对宽高比和时长参数无特殊限制； 但需避免在参考生视频任务的提示词中出现与视频编辑、延长相关的词语，防止模型误判触发报错 。 视频编辑 视频编辑任务 任务触发条件（两级判定） 特殊限制 对原视频的画面或音频进行编辑操作（如替换视频主体、视频中对象增删改、局部画面重绘/修复等） 参数 content.role 需设置为 reference_image / reference_video / reference_audio 提示词触发关键词，包含其一即可： 编辑视频、增加/加上、删除/去掉、修改/替换/改成 @video1 中加一些小动物；把 @video1 的人物修改为 @image1；删掉 @video1 的背景音乐 宽高比 ，仅支持配置参数 ratio 为 adaptive ，即模型自动保持输出视频和待编辑视频（由模型判定）的宽高比一致，不支持另行设置 时长 ，仅支持配置参数 duration 为 -1，即模型自动保持输出视频和待编辑视频的时长基本一致， 不支持自定义 视频延长 视频延长任务 任务触发条件（两级判定） 特殊限制 对原视频进行向前/向后延长 参数 content.role 需设置为 reference_image / reference_video / reference_audio 提示词触发关键词，包含其一即可： 向前/向后延长、延续、续写 向后延长 @video1，@image1 的角色从天而降...；续写 @video1 前 5s，@video2 女人入画说... 宽高比 ，仅支持配置参数 ratio 为 adaptive ，即模型自动保持输出视频和待延长视频（由模型判定）的宽高比一致， 不支持自定义 首帧/首尾帧生视频 首帧/首尾帧生视频任务 任务触发条件 特殊限制 输入 1 张图作为首帧生成视频，或输入 2 张图分别作为首帧和尾帧生成视频 参数 content.role 需设置为 first_frame / last_frame 宽高比 ，仅支持配置参数 ratio 为 adaptive ，即模型自动保持输出视频和输入首帧图的宽高比一致， 不支持自定义 非法传参报错机制 当模型判定任务类型为 视频编辑、视频延长、首帧/首尾帧生视频 任务时，若宽高比（ ratio）和时长（ duration）参数配置不合法，将产生异步报错： 异步报错 当参数 content.role配置为 reference_image / reference_video / reference_audio时，模型需要根据提示词意图判定具体的子任务类型（参考生视频、视频编辑、视频延长），进而校验对应子任务下输入参数的合法性（如编辑任务中 ratio 必须为 adaptive），因此该情况下 相关报错信息需排队等待任务启动、模型完成判定后异步返回。 说明 当多个参数同时违规时，报错信息将一次性列出所有违规项。 因任务类型导致的参数不兼容报错，其错误码为 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 模型。 下载并解压文件 ：点击下载下方附件，将其解压到您的本地目录（如桌面或“下载”文件夹）。 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)。 打开终端，进入 scripts/init_dev_env 目录。 运行构建脚本： Plain ./setup_mac.sh 脚本会自动配置好所有环境。 完成后，在项目根目录会生成一个 run_demo.sh。 运行 ./run_demo.sh 即可运行 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, 720p 480p, 720p, 1080p, 4k 480p, 720p 480p, 720p 输出宽高比 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 离线推理 特色能力 30 秒视频连贯直出 Seedance 2.5 视频生成时长上限由 Seedance 2.0 系列的 15 秒延长至 30 秒，支持一次性生成长达 30 秒的连贯视频，无需多段拼接即可呈现完整故事。 输入：文本 + 图片 输出 提示词：一段高级、极具电影感的30秒3D动态图形序列，采用精致的蒸汽朋克与复古微缩景观风格...（详见下方代码示例中的完整提示词） Curl Python Java Go Bash curl -X POST 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": "一段高级、极具电影感的30秒3D动态图形序列，采用精致的蒸汽朋克与复古微缩景观风格，配合连续流畅的环绕与穿透运镜。 [0-10秒]： 古董黄铜钟面微距特写，奇迹般层层展开为相互啮合的旋转齿轮环与体积雾。镜头向下穿透齿轮，一架机械扑翼机（Ornithopter），正从由做旧古籍堆叠而成的微缩峡谷中盘旋升空。 [10-20秒]： 镜头跟随扑翼机的轨迹向前滑行，无缝穿透入一个高速旋转的华丽黄铜幻影箱（Zoetrope），内部投射出飞驰的机械骏马动态光影。光影跃出箱体，场景瞬间化为一辆黄铜质感悬浮缆车，正沿着微光铜轨穿梭于机械齿轮森林，沐浴着电影级的黄金时刻光线。 [20-30秒]： 镜头优雅向下平移，缆车下方出现一艘精美的发条木制机械帆船，在深蓝色玻璃材质的起伏海浪中破浪前行。海浪尽头无缝演变为一轮发光巨月，一群举着摇曳提灯的探险者剪影，正沿着星空下的水晶矿脉山脊艰难跋涉。镜头平滑螺旋拉远，穿过空灵云朵，回到滴答作响的宏大黄铜钟面。最后一秒出现 logo，参考@图像1。 技术规格： 超写实机械纹理，丰富黄铜与金色调，电影级浅景深。平滑连贯的无缝穿梭运镜，极强的史诗感与奇幻冒险氛围。" "type": "image_url", "image_url": { "url": "https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/seedance2.5_30s_input.png" "role": "reference_image" "generate_audio": true, "ratio": "16:9", "duration": 30, Python import os import time # Install SDK: pip install 'volcengine-python-sdk[ark]' from volcenginesdkarkruntime import Ark client = Ark( # The base URL for model invocation base_url='https://ark.cn-beijing.volces.com/api/v3', # Get API Key：https://console.volcengine.com/ark/region:cn-beijing/apikey api_key=os.environ.get("ARK_API_KEY"), if __name__ == "__main__": print("----- create request -----") create_result = client.content_generation.tasks.create( model="doubao-seedance-2-5-260628", # Replace with Model ID content=[ "type": "text", "text": "一段高级、极具电影感的30秒3D动态图形序列，采用精致的蒸汽朋克与复古微缩景观风格，配合连续流畅的环绕与穿透运镜。 [0-10秒]： 古董黄铜钟面微距特写，奇迹般层层展开为相互啮合的旋转齿轮环与体积雾。镜头向下穿透齿轮，一架机械扑翼机（Ornithopter），正从由做旧古籍堆叠而成的微缩峡谷中盘旋升空。 [10-20秒]： 镜头跟随扑翼机的轨迹向前滑行，无缝穿透入一个高速旋转的华丽黄铜幻影箱（Zoetrope），内部投射出飞驰的机械骏马动态光影。光影跃出箱体，场景瞬间化为一辆黄铜质感悬浮缆车，正沿着微光铜轨穿梭于机械齿轮森林，沐浴着电影级的黄金时刻光线。 [20-30秒]： 镜头优雅向下平移，缆车下方出现一艘精美的发条木制机械帆船，在深蓝色玻璃材质的起伏海浪中破浪前行。海浪尽头无缝演变为一轮发光巨月，一群举着摇曳提灯的探险者剪影，正沿着星空下的水晶矿脉山脊艰难跋涉。镜头平滑螺旋拉远，穿过空灵云朵，回到滴答作响的宏大黄铜钟面。最后一秒出现 logo，参考@图像1。 技术规格： 超写实机械纹理，丰富黄铜与金色调，电影级浅景深。平滑连贯的无缝穿梭运镜，极强的史诗感与奇幻冒险氛围。", "type": "image_url", "image_url": { "url": "https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/seedance2.5_30s_input.png" "role": "reference_image", generate_audio=True, ratio="16:9", duration=30, print(create_result) # Polling query section print("----- polling task status -----") task_id = create_result.id while True: get_result = client.content_generation.tasks.get(task_id=task_id) status = get_result.status if status == "succeeded": print("----- task succeeded -----") print(get_result) break elif status == "failed": print("----- task failed -----") print(f"Error: {get_result.error}") break else: print(f"Current status: {status}, Retrying after 30 seconds...") time.sleep(30) Java package com.ark.sample; import com.volcengine.ark.runtime.model.content.generation.*; import com.volcengine.ark.runtime.model.content.generation.CreateContentGenerationTaskRequest.Content; import com.volcengine.ark.runtime.service.ArkService; import okhttp3.ConnectionPool; import okhttp3.Dispatcher; import java.util.ArrayList; import java.util.List; import java.util.concurrent.TimeUnit; public class ContentGenerationTaskExample { // Client initialization static String apiKey = System.getenv("ARK_API_KEY"); static ConnectionPool connectionPool = new ConnectionPool(5, 1, TimeUnit.SECONDS); static Dispatcher dispatcher = new Dispatcher(); static ArkService service = ArkService.builder() .baseUrl("https://ark.cn-beijing.volces.com/api/v3") // The base URL for model invocation .dispatcher(dispatcher) .connectionPool(connectionPool) .apiKey(apiKey) .build(); public static void main(String[] args) { // Model ID final String modelId = "doubao-seedance-2-5-260628"; // Text prompt final String prompt = "一段高级、极具电影感的30秒3D动态图形序列，采用精致的蒸汽朋克与复古微缩景观风格，配合连续流畅的环绕与穿透运镜。 [0-10秒]： 古董黄铜钟面微距特写，奇迹般层层展开为相互啮合的旋转齿轮环与体积雾。镜头向下穿透齿轮，一架机械扑翼机（Ornithopter），正从由做旧古籍堆叠而成的微缩峡谷中盘旋升空。 [10-20秒]： 镜头跟随扑翼机的轨迹向前滑行，无缝穿透入一个高速旋转的华丽黄铜幻影箱（Zoetrope），内部投射出飞驰的机械骏马动态光影。光影跃出箱体，场景瞬间化为一辆黄铜质感悬浮缆车，正沿着微光铜轨穿梭于机械齿轮森林，沐浴着电影级的黄金时刻光线。 [20-30秒]： 镜头优雅向下平移，缆车下方出现一艘精美的发条木制机械帆船，在深蓝色玻璃材质的起伏海浪中破浪前行。海浪尽头无缝演变为一轮发光巨月，一群举着摇曳提灯的探险者剪影，正沿着星空下的水晶矿脉山脊艰难跋涉。镜头平滑螺旋拉远，穿过空灵云朵，回到滴答作响的宏大黄铜钟面。最后一秒出现 logo，参考@图像1。 技术规格： 超写实机械纹理，丰富黄铜与金色调，电影级浅景深。平滑连贯的无缝穿梭运镜，极强的史诗感与奇幻冒险氛围。"; // Example resource URLs final String refImage1 = "https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/seedance2.5_30s_input.png"; // Output video parameters final boolean generateAudio = true; final String videoRatio = "16:9"; final long videoDuration = 30L; System.out.println("----- create request -----"); // Build request content List