API参考
请输入
- 火山方舟
视频生成 API创建视频生成任务
复制全文
下载 pdf视频生成 API
创建视频生成任务
复制全文下载 pdf创建视频生成任务
文档反馈POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks
本文介绍创建视频生成任务 API 的输入输出参数，供您使用接口时查阅字段含义。模型会依据传入的图片及文本信息生成视频，待生成完成后，您可以按条件查询任务并获取生成的视频。
使用必读
限时优惠
- Seedance 2.5 ：北京时间（UTC+8）2026 年 8 月 14 日 14:00 至 9 月 17 日 14:00 期间，1080p 分辨率按刊例价 72 折计费（480p、720p 不参与折扣）， 最低降至约 2.7 元/秒 。
- Seedance 2.0 mini ：北京时间（UTC+8）2026 年 8 月 7 日 14:00 至 9 月 7 日 14:00 期间，480p、720p 分辨率均按刊例价 4 折计费，以 720p 为例， 最低降至约 0.2 元/秒 。
- Seedance 2.0 fast ：北京时间（UTC+8）2026 年 8 月 7 日 14:00 至 9 月 7 日 14:00 期间，480p、720p 分辨率均按刊例价 75 折计费，以 720p 为例， 最低降至约 0.6 元/秒 。
模型能力
- Doubao Seedance 2.5new （有声视频 / 无声视频）
- 全模态参考生视频 ：输入参考图片（0-30 张）+ 参考视频（0-10 个）+ 参考音频（0-10 个）+ 文本提示词（可选）生成 1 个目标视频。支持仅传入音频。支持生成全新视频、编辑视频、延长视频，支持 30 秒视频连贯直出。
- 图生视频-首尾帧 ：输入首帧图片 + 尾帧图片 + 文本提示词（可选）生成 1 个目标视频。
- 图生视频-首帧 ：输入首帧图片 + 文本提示词（可选）生成 1 个目标视频。
- 文生视频 ：输入文本提示词生成 1 个目标视频。
- 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
- 支持【图生视频-首帧】【文生视频】。
参数传入方式说明
说明
- 对于 resolution、ratio、duration、frames、seed、camera_fixed、watermark 参数，除了在 request body 中直接传入，也支持在文本提示词后追加 --[parameters] 的弱校验方式传参，所有模型均兼容。
- 不同模型对应支持不同的参数与取值，详见 输出视频格式。当输入的参数或取值不符合所选的模型时，该参数将被忽略或触发报错：
- 常规方式（推荐） ：在 request body 中直接传入参数。此方式为 强校验 ，若参数填写错误，模型会返回错误提示。
- 弱校验方式 ：在文本提示词后追加 --[parameters]。若参数填写错误，该参数将被忽略或触发报错。
常规方式（推荐）：在 request body 中直接传入参数
弱校验方式：在文本提示词后追加 --[parameters]
鉴权
- API Key 鉴权，请在 API Key 管理 页面，获取长效 API Key。
请求参数
Body 参数
content object[] 必选 | 输入内容列表
输入给模型生成视频的信息，支持文本、图片、音频、视频、样片任务 ID 等多种类型的元素。
支持以下几种组合：
- 纯文本
- 文本（可选）+ 图片
- 文本（可选）+ 视频
- 文本（可选）+ 音频（仅 Seedance 2.5 支持单独传入音频）
- 文本（可选）+ 图片 + 音频
- 文本（可选）+ 图片 + 视频
- 文本（可选）+ 视频 + 音频
- 文本（可选）+ 图片 + 视频 + 音频
- 样片任务 ID：样片指使用 Seedance 模型成功生成的样片视频，模型可基于样片生成高质量正式视频
注意
Seedance 2.5、Seedance 2.0 系列模型不支持直接上传含有真人人脸的参考图 / 视频。
- 支持使用部分模型的含人脸原始产物作为输入素材
- 支持使用预置虚拟人像作为输入素材
- 支持使用已授权真人素材作为输入
文本信息 object
文本部分，作为生成内容的文本提示词。
text string 必选 | 文本提示词
content.text
输入给模型的文本提示词，描述期望生成的视频。
说明
- 提示词语言支持 ：所有模型均支持中英文提示词；
- Seedance 2.5 ：额外支持西班牙语、印度尼西亚语、葡萄牙语、日语、马来语、泰语、阿拉伯语、越南语、韩语；
- Seedance 2.0 系列 ：额外支持西班牙语、印度尼西亚语、葡萄牙语、日语。
- 提示词字数建议 ：中文提示词不超过 500 字，英文提示词不超过 1000 词。字数过多易导致信息分散，模型可能忽略细节、仅关注重点，进而造成视频缺失部分元素。
- 更多使用技巧 ：提示词的详细使用技巧，请参见 Seedance 提示词指南。
type string 必选 | 内容类型
content.type
输入内容的类型，此处固定为 text。
图片信息 object
输入给模型的图片信息。
image_url object 必选 | 图片对象
content.image_url
输入给模型的图片对象。
url string 必选 | 图片来源
content.image_url.url
图片 URL、图片 Base64 编码、素材 ID。
- 图片 URL ：填入图片的公网 URL。
- Base64 编码 ：将本地文件转换为 Base64 编码字符串后提交给大模型，遵循格式 data:image/<图片格式>;base64,<Base64 编码>，注意 <图片格式> 需小写，如 data:image/png;base64,{base64_image}。
- 素材 ID ：用于视频生成的预置素材及虚拟人像的 ID，遵循格式 asset://<ASSET_ID>。可从 素材 & 虚拟人像库 获取。
传入单张图片要求
- 格式 ：jpeg、png、webp、bmp、tiff、gif。其中，Seedance 1.5 pro 及以上模型版本额外支持 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 张
type string 必选 | 内容类型
content.type
输入内容的类型，此处固定为 image_url。
role string | 角色/用途
content.role
图片的位置或用途。
图生视频-首帧
字段 role 取值 ：需要传入 1 个 image_url 对象，role 为 first_frame 或不填。
图生视频-首尾帧
字段 role 取值 ：需要传入 2 个 image_url 对象，且 role 必填。
- 首帧图片对应的 role 为 first_frame
- 尾帧图片对应的 role 为 last_frame
说明
传入的首尾帧图片可相同。首尾帧图片的宽高比不一致时，以首帧图片为主，尾帧图片会自动裁剪适配。
模型支持 ：
- Seedance 2.5
- Seedance 2.0 系列
- Seedance 1.5 pro
- Seedance 1.0 pro
图生视频-参考图
字段 role 取值 ：必填，每张参考图对应的 role 均为 reference_image。
模型支持 ：
- Seedance 2.5
- Seedance 2.0 系列
注意
- 图生视频-首帧 、 图生视频-首尾帧 、 全模态参考生视频 （包括参考图、视频、音频）为 3 种互斥场景， 不可混用 。
- 全模态参考生视频 可通过提示词指定参考图片作为首帧 / 尾帧，间接实现「首尾帧 + 全模态参考」效果。若需严格保障首尾帧和指定图片一致， 优先使用图生视频-首尾帧 （配置 role 为 first_frame / last_frame）。
视频信息 object
输入给模型的视频信息。
方舟平台信任 Seedance 2.5、Seedance 2.0 系列模型生成的含人脸视频，您可使用 本账号下近 30 天内 由上述模型生成的含人脸原始视频，作为输入素材进行二次创作。
模型支持 ：
- Seedance 2.5
- Seedance 2.0 系列
type string 必选 | 内容类型
content.type
输入内容的类型，此处固定为 video_url。
video_url object 必选 | 视频对象
content.video_url
输入给模型的视频对象。
url string 必选 | 视频来源
content.video_url.url
视频 URL、素材 ID。
- 视频 URL ：填入视频的公网 URL。
- 素材 ID ：用于视频生成的预置素材及虚拟人像视频的 ID，遵循格式 asset://<ASSET_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]
支持的视频编码格式 ：
role string | 角色/用途
content.role
视频的位置或用途，此处固定为 reference_video。
音频信息 object
用作参考音频。
模型支持 ：
- Seedance 2.5 ：可仅传入音频，无需搭配图片 / 视频；也可配合图片 / 视频一起传入
- Seedance 2.0 系列 ：不可单独输入音频，应至少包含 1 个参考视频或图片。
audio_url object 必选 | 音频对象
content.audio_url
输入给模型的音频对象。
url string 必选 | 音频来源
content.audio_url.url
音频 URL、音频 Base64 编码、素材 ID。
- 音频 URL ：填入音频的公网 URL。
- Base64 编码 ：将本地文件转换为 Base64 编码字符串后提交给大模型，遵循格式 data:audio/<音频格式>;base64,<Base64 编码>，注意 <音频格式> 需小写，如 data:audio/wav;base64,{base64_audio}。
- 素材 ID ：用于视频生成的虚拟人的音频素材 ID，遵循格式 asset://<ASSET_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 编码。
type string 必选 | 内容类型
content.type
输入内容的类型，此处固定为 audio_url。
role string | 角色/用途
content.role
音频的位置或用途，此处固定为 reference_audio。
样片信息 object
模型支持 ：
- Seedance 1.5 pro
draft_task object 必选 | 样片任务对象
content.draft_task
输入给模型的样片任务对象。
id string 必选 | 样片任务 ID
content.draft_task.id
样片任务 ID。
平台将自动复用 Draft 视频使用的用户输入（ model 、content. text 、content. image_url 、 generate_audio 、 seed 、 ratio 、 duration 、 camera_fixed ），生成正式视频。其余参数支持指定，不指定将使用本模型的默认值。
使用分为两步：
- Step 1 ：调用本接口生成 Draft 视频。
- Step 2 ：如果确认 Draft 视频符合预期，可基于 Step 1 返回的 Draft 视频任务 ID 调用本接口生成最终视频。
type string 必选 | 内容类型
content.type
输入内容的类型，此处固定为 draft_task。
model string 必选 | 模型 ID
callback_url string | 回调地址
说明
回调返回的 status 包括以下状态：
- queued：排队中
- running：任务运行中
- succeeded：任务成功（如发送失败，即 5 秒内未接收到成功发送的信息，会回调三次）
- failed：任务失败（如发送失败，即 5 秒内未接收到成功发送的信息，会回调三次）
- expired：任务超时，即任务处于「运行中或排队中」状态超过过期时间，可通过 execution_expires_after 字段设置过期时间
camera_fixed boolean 默认值 false | 固定摄像头
是否固定摄像头。
- true：固定摄像头。平台会在用户提示词中追加固定摄像头，实际效果不保证。
- false：不固定摄像头。
参考图场景不支持。
模型支持 ：
- Seedance 1.5 pro
- Seedance 1.0 pro
- Seedance 1.0 pro fast
draft boolean 默认值 false | 样片模式
- true：开启样片模式，生成一段预览视频，快速验证场景结构、镜头调度、主体动作与 Prompt 意图是否符合预期。消耗 token 数较正常视频更少，使用成本更低。
- false：关闭样片模式，正常生成一段视频。
说明
开启样片模式后，将使用 480p 分辨率生成 Draft 视频（使用其他分辨率会报错），不支持返回尾帧功能，不支持离线推理功能。
模型支持 ：
- Seedance 1.5 pro
duration integer | 视频时长
生成视频时长（单位：秒）。
duration 和 frames 二选一即可，frames 优先级更高。如果您希望生成整数秒的视频，建议指定 duration。
duration 适配规则
模型 | duration = -1取值规则 |
Seedance 2.0 系列、1.5 pro | 模型在 duration 的有效取值范围内，自主选择合适的视频长度（整数秒）。 |
Seedance 2.5（视频编辑任务） | 自动保持输出视频和输入视频的时长基本一致（输出时长可能略短于输入视频，误差约 0.4 秒），不支持另行设置。 |
Seedance 2.5（其他任务类型） | 模型在 duration 的有效取值范围内，自主选择合适的视频长度（整数秒）。 |
duration 返回值说明
通过 查询视频生成任务 API 接口返回的 duration 值为视频的时长约数（整数秒），与实际的视频时长可能不同。具体返回规则如下：
- 计算公式：接口返回的 duration = 实际总帧数 / 24（向下取整）
- 举例：若最终生成视频为 133 帧，视频实际时长为 133 / 24 = 5.54 秒；向下取整后，duration 最终返回值为 5
注意
- 仅支持配置duration为 -1，不支持指定具体输出时长。
- 传入的待编辑视频时长需在 [4, 30]s 内，否则将触发报错。
模型支持 ：
- Seedance 2.5 ：默认值 -1；取值范围 [4, 30]；或设置为 -1（智能选择）
- Seedance 2.0 系列 ：取值范围 [4, 15]；或设置为 -1（智能选择）
- Seedance 1.5 pro ：取值范围 [4, 12]；或设置为 -1（智能选择）
- Seedance 1.0 pro ：取值范围 [2, 12]
- Seedance 1.0 pro fast ：取值范围 [2, 12]
execution_expires_after integer 默认值 172800 | 任务超时阈值
任务超时阈值。指定任务提交后的过期时间（单位：秒），从 created_at 时间戳开始计算，默认 48 小时。
超过该时间后任务会被自动终止，并标记为 expired 状态。
不论使用哪种 service_tier，都建议根据业务场景设置合适的超时时间。
取值范围 ：[3600, 259200]
frames integer | 视频帧数
生成视频的帧数。通过指定帧数可以灵活控制生成视频的长度，生成小数秒的视频。
由于 frames 的取值限制，仅能支持有限小数秒，您需要根据公式推算最接近的帧数：
- 计算公式 ：帧数 = 时长 × 帧率（24）
- 格式约束 ：支持 [29, 289] 区间内所有满足 25 + 4n 格式的整数值，其中 n 为正整数
举例 ：假设需要生成 2.4 秒的视频，帧数 = 2.4 × 24 = 57.6。由于 frames 不支持 57.6，您只能选择一个最接近的值——根据 25 + 4n 计算出最接近的帧数为 57，实际生成的视频为 57 / 24 = 2.375 秒。
duration 和 frames 二选一即可，frames 优先级更高。
取值范围 ：[29, 289]
模型支持 ：
- Seedance 1.0 pro
- Seedance 1.0 pro fast
generate_audio boolean 默认值 true | 生成有声视频
控制生成的视频是否包含与画面同步的声音。
- true：模型输出的视频包含同步音频，模型会基于文本提示词与视觉内容自动生成匹配的人声、音效及背景音乐。建议将对话部分置于双引号内以优化音频生成效果，例如：男人叫住女人说："你记住，以后不可以用手指指月亮。"
- false：模型输出的视频为无声视频。
注意
生成的有声视频均为单声道，和传入的音频声道数无关。
模型支持 ：
- Seedance 2.5
- Seedance 2.0 系列
- Seedance 1.5 pro
omni_reference_task_typenew string 默认值 auto | 任务类型引导
Seedance 2.5 全模态参考生视频任务 包括参考生视频、视频编辑和视频延长 3 类子任务。不同任务类型对参数有特殊限制，为减少任务创建后异步报错的情况，可通过本参数指定子任务类型，以提前校验对应限制。
- 默认情况下，即 omni_reference_task_type=auto：模型根据输入素材和提示词自动判定任务类型，再校验参数取值。如果参数与实际任务类型不兼容，任务将触发 异步报错（错误码：InvalidParameter.TaskTypeConstraint）。
- 显式指定任务类型，即 omni_reference_task_type 为 reference、edit 或 extend：接口在提交任务时提前校验对应任务的特殊参数限制。不符合要求时，接口立即报错，任务不会创建。
注意
实际处理任务时，模型仍会进一步结合提示词判断任务类型。若实际判定的任务类型和指定的不一致，仍会触发 异步报错（错误码：InvalidParameter.TaskTypeMismatch）。建议遵循各任务类型的 提示词写法，降低报错概率。
可选值：
- auto：由模型根据输入素材和提示词自动判定任务类型。
- reference：参考生视频任务，即基于参考图片、参考视频或参考音频生成新视频。设置 reference 时，ratio 或 duration 无特殊限制。
- edit：视频编辑任务，即对原视频的画面或音频进行编辑操作。设置 edit 时，content 中必须至少包含一个 reference_video，且视频时长必须为 4–30 秒；ratio 必须为 adaptive；duration 必须为 -1。
- extend：视频延长任务，即对原视频向前或向后延长。设置 extend 时，content 中必须至少包含一个 reference_video；ratio 必须为 adaptive。
模型支持 ：
- Seedance 2.5
output_formatnew string 默认值 mp4 | 输出格式
输出视频的格式。
- mp4：通用格式，兼容性最好，采用标准色彩精度，可在网页、移动端、各类播放器及分发平台直接播放。
- mov：面向专业场景的高色彩精度格式，更好地保持画面色彩与亮度一致性、适用于调色、抠像、合成等对色彩还原要求高的专业后期加工。推荐在视频编辑、视频延长场景使用 mov 格式作为输入和输出。
mov 格式播放兼容性
mov 格式采用专业编码（H.264视频编码+yuv444p 色度采样+PCM 音频编码），部分播放器可能不兼容。以下为常见的支持播放 mov 格式的播放器：
播放器 | macOS | Windows |
IINA | ✓ | ✕ |
VLC | ✓ | ✓ |
mpv | ✓ | ✓ |
ffplay | ✓ | ✓ |
模型支持 ：
- Seedance 2.5
priority integer 默认值 0 | 执行优先级
设置当前请求的执行优先级，决定其在队列中的排序位置。数值越大，优先级越高。
默认情况下，请求按 FIFO（First In, First Out，先进先出）顺序执行；设置较高优先级后，该请求将插队到同 Endpoint（推理接入点）下所有低优先级请求之前。
示例 ：某 Endpoint 当前队列中有 3 个排队中（status=queued）任务，优先级均为 0（默认）：
此时提交一个 priority=5 的新请求，该请求将直接排到队首：
说明
- 相同优先级的请求之间仍按 FIFO 排序。
- 优先级仅影响排队顺序，不会中断正在执行中（status=running）的任务。
- 优先级仅在同一 Endpoint 内生效，不影响其他 Endpoint。
- 离线推理模式（service_tier=flex）不支持配置优先级。
取值范围 ：[0, 9]
模型支持 ：
- Seedance 2.5
- Seedance 2.0 系列
ratio string | 视频宽高比
生成视频的宽高比例。
- 可选值：16:9、4:3、1:1、3:4、9:16、21:9、adaptive（根据任务类型和输入内容自动适配宽高比）
不同模型的取值限制和 adaptive 适配规则
模型支持 ：
- Seedance 2.5 ：默认值 adaptive
- Seedance 2.0 系列 ：默认值 adaptive
- Seedance 1.5 pro ：默认值 adaptive
- Seedance 1.0 pro ：文生视频默认 16:9，图生视频默认 adaptive
- Seedance 1.0 pro fast ：文生视频默认 16:9，图生视频默认 adaptive
resolution string | 视频分辨率
视频分辨率。可选值：480p、720p、1080p、4k。
说明
- Seedance 2.5 输出的 1080p 视频和 Seedance 2.0 输出的 4k 视频均采用 10bit 位深与 H.265/HEVC 编码。
- 相较于一般的 8bit 位深，10bit 位深能够保留更丰富的色彩层次与更平滑的渐变过渡，满足专业影视制作与 HDR 视频内容的要求。
- H.265/HEVC 编码在少数播放环境中可能不兼容。如遇问题，建议升级系统、更换设备，或使用 VLC、MPV、QuickTime Player 等播放器查看。播放兼容性说明详见 10bit 位深与 H.265/HEVC 编码视频播放兼容性说明。
模型支持 ：
- Seedance 2.5 ：默认值 720p；可选值 480p、720p、1080p
- Seedance 2.0 ：默认值 720p；可选值 480p、720p、1080p、4k
- Seedance 2.0 fast ：默认值 720p；可选值 480p、720p
- Seedance 2.0 mini ：默认值 720p；可选值 480p、720p
- Seedance 1.5 pro ：默认值 720p；可选值 480p、720p、1080p
- Seedance 1.0 pro ：默认值 1080p；可选值 480p、720p、1080p
- Seedance 1.0 pro fast ：默认值 1080p；可选值 480p、720p、1080p
return_last_frame boolean 默认值 false | 返回尾帧
是否返回生成视频的尾帧图像。
- true：返回生成视频的尾帧图像，可通过 查询视频生成任务接口 获取，尾帧图像的格式为 png，宽高像素值与生成的视频保持一致，无水印。
- false：不返回生成视频的尾帧图像。
safety_identifier string | 用户标识
终端用户的唯一标识符，用于协助平台检测您的应用中可能违反火山方舟使用政策的用户。该标识符为英文字符串，需保证对单个用户固定且唯一，长度不超过 64 个字符。
推荐传入对用户名、用户 ID 或邮箱进行哈希处理后生成的字符串，避免泄露用户隐私信息。
seed integer 默认值 -1 | 随机种子
种子整数，用于控制生成内容的随机性。-1 表示使用随机数替代。
注意
- 相同的请求下，模型收到不同的 seed 值（不指定、令 seed=-1 或手动变更），将生成不同的结果。
- 相同的请求下，模型收到相同的 seed 值，会生成类似的结果，但不保证完全一致。
取值范围 ：[-1, 2147483647]
模型支持 ：
- Seedance 1.5 pro
- Seedance 1.0 pro
- Seedance 1.0 pro fast
tools object[] | 工具配置
配置模型要调用的工具。
模型支持 ：
- Seedance 2.5
- Seedance 2.0 系列
type string 必选 | 工具类型
tools.type
指定使用的工具类型。
- web_search：联网搜索工具。开启联网搜索后，模型会根据用户的提示词自主判断是否搜索互联网内容（如商品、天气等）。可提升生成视频的时效性，但也会增加一定的时延。阅读教程 获取详细代码示例。
说明
watermark boolean 默认值 false | 视频水印
生成视频是否包含水印。
- true：生成视频右下角会展示 AI 生成 水印。
- false：生成视频不含水印。
响应参数
id string | 任务 ID
视频生成任务 ID。仅保存 7 天（从 created_at 时间戳开始计算），超时后将自动清除。
- 设置 "draft": true，为 Draft 视频任务 ID。
- 设置 "draft": false，为正常视频任务 ID。
多模态参考
编辑视频
延长视频
有声视频-首帧
有声视频-首尾帧
图生视频-base64编码
文生视频
request
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": "明亮多彩的广告片风格，果味饼干为主角，包含草莓、苹果、葡萄、橙子四种口味，草莓味参考@图像1，饼干与对应水果以强秩序感的几何阵列排布，整体画面干净、高级、节奏强。开场水果快速建立视觉聚焦，参考@视频1的构图，音乐重拍切入。随后不同口味饼干整齐排列，切特写，参考@视频2的动态和运镜。高潮段一块饼干被折断，瞬间进入慢动作，果味夹心爆开，碎屑飞溅，果汁感与颗粒冲击被放大展示，参考@视频3的冲击感。横向阵列，形成节奏抛物感，参考@视频4的运动，突出秩序美感与产品丰富度。随后迅速回到快节奏剪辑。结尾英文文字 One bite of crispness, a heart full of delight 快速分词切换入画，配合强节奏文字运动与产品定格，参考@视频5，最终品牌感收束，饼干和水果向四周发散，参考@视频6画面充满年轻、活力、好吃、想分享的广告氛围。",
},
{
"type": "image_url",
"image_url": {
"url": "https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/seedance2.5_reference1.png"
},
"role": "reference_image",
},
{
"type": "video_url",
"video_url": {
"url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference2.mp4"
},
"role": "reference_video",
},
{
"type": "video_url",
"video_url": {
"url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference3.mp4"
},
"role": "reference_video",
},
{
"type": "video_url",
"video_url": {
"url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference4.mp4"
},
"role": "reference_video",
},
{
"type": "video_url",
"video_url": {
"url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference5.mp4"
},
"role": "reference_video",
},
{
"type": "video_url",
"video_url": {
"url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference6.mp4"
},
"role": "reference_video",
},
{
"type": "video_url",
"video_url": {
"url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference7.mp4"
},
"role": "reference_video",
},
],
generate_audio=True,
ratio="16:9",
duration=15,
)
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 10 seconds...")
time.sleep(10)response
----- create request -----
ContentGenerationTaskID(id='cgt-20260414114820-*****')
----- polling task status -----
Current status: running, Retrying after 10 seconds...
Current status: running, Retrying after 10 seconds...
Current status: running, Retrying after 10 seconds...
...
----- task succeeded -----
ContentGenerationTask(id='cgt-20260414114820-*****', model='doubao-seedance-2-0-260128', status='succeeded', error=None, content=Content(video_url='https://xxx', last_frame_url=None, file_url=None), usage=Usage(completion_tokens=411300, total_tokens=411300), frames=None, framespersecond=24, created_at=1776138520, updated_at=1776139219, seed=33608, service_tier='default', execution_expires_after=172800, generate_audio=True, duration=11, ratio='16:9', resolution='720p', draft=False, draft_task_id=None)最近更新时间：2026.08.21 11:18:09
这个页面对您有帮助吗？
有用
有用
无用
无用