面向 AI 助手：本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/create-video-generation-task-api.md，全部文档索引见 https://ark.volcengine.com/llms.txt。

创建视频生成任务

POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks

本文介绍创建视频生成任务 API 的输入输出参数，供您使用接口时查阅字段含义。模型会依据传入的图片及文本信息生成视频，待生成完成后，您可以按条件查询任务并获取生成的视频。

模型开通条件

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

  • 【推荐】账户余额 > 200 元（前往充值）
  • 【推荐】购买 200 元档位及以上专属节省计划，购买入口：购买节省计划。
  • 已购买 Seedance 2.5、Seedance 2.0 系列资源包且有可用余量（前往购买）

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

模型能力
  • 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.0 pro
    • 支持【图生视频-首尾帧】【图生视频-首帧】【文生视频】。
  • Doubao Seedance 1.0 pro fast
    • 支持【图生视频-首帧】【文生视频】。
参数传入方式说明

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

JSON
{
    "model": "doubao-seedance-1-0-pro-250528",
    "content": [
        {
            "type": "text",
            "text": "小猫对着镜头打哈欠"
        }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "seed": 11,
    "camera_fixed": false,
    "watermark": true
}

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

JSON
{
    "model": "doubao-seedance-1-0-pro-250528",
    "content": [
        {
            "type": "text",
            "text": "小猫对着镜头打哈欠 --rs 720p --rt 16:9 --dur 5 --seed 11 --cf false --wm true"
        }
    ]
}

鉴权#

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

  • API Key 鉴权，请在 API Key 管理 页面，获取长效 API Key。

请求参数#

Body 参数#

model string 必选  |  模型 ID

您需要调用的模型的 ID（Model ID）。开通模型服务 后可 查询 Model ID。

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

content object[] 必选  |  输入内容列表

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

支持以下几种组合：

  • 纯文本
  • 文本（可选）+ 图片
  • 文本（可选）+ 视频
  • 文本（可选）+ 音频（仅 Seedance 2.5 支持单独传入音频）
  • 文本（可选）+ 图片 + 音频
  • 文本（可选）+ 图片 + 视频
  • 文本（可选）+ 视频 + 音频
  • 文本（可选）+ 图片 + 视频 + 音频
  • 样片任务 ID：样片指使用 Seedance 模型成功生成的样片视频，模型可基于样片生成高质量正式视频
文本信息 object

文本部分，作为生成内容的文本提示词。

text string 必选  |  文本提示词

content.text

输入给模型的文本提示词，描述期望生成的视频。

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>。可从 素材 & 虚拟人像库 获取。
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.0 pro
图生视频-参考图

字段 role 取值：必填，每张参考图对应的 role 均为 reference_image。

模型支持：

  • Seedance 2.5
  • Seedance 2.0 系列
视频信息 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>。可从 素材 & 虚拟人像库 获取。

支持的视频编码格式：

容器格式 常用文件扩展名 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
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>。可从 素材 & 虚拟人像库 获取。
type string 必选  |  内容类型

content.type

输入内容的类型，此处固定为 audio_url。

role string  |  角色/用途

content.role

音频的位置或用途，此处固定为 reference_audio。

样片信息 object

样片信息。基于样片任务 ID，生成正式视频。阅读文档 获取 draft 功能的使用教程和注意事项。

模型支持：

  • Seedance 2.5
draft_task object 必选  |  样片任务对象

content.draft_task

输入给模型的样片任务对象。

id string 必选  |  样片任务 ID

content.draft_task.id

样片任务 ID。

基于 Draft 视频生成正式视频时，部分参数由模型自动复用，部分参数禁止重复传入，部分参数可重新指定。详细规则参见 Seedance 2.5 样片模式。

使用分为两步：

  • Step 1：调用本接口生成 Draft 视频。
  • Step 2：如果确认 Draft 视频符合预期，可基于 Step 1 返回的 Draft 视频任务 ID 调用本接口生成最终视频。
type string 必选  |  内容类型

content.type

输入内容的类型，此处固定为 draft_task。

omni_reference_task_typenew string 默认值 auto  |  任务类型引导

Seedance 2.5 全模态参考生视频任务包括参考生视频、视频编辑和视频延长 3 类子任务。不同任务类型对参数有特殊限制，为减少任务创建后异步报错的情况，可通过本参数指定子任务类型，以提前校验对应限制。

  • 默认情况下，即 omni_reference_task_type=auto：模型根据输入素材和提示词自动判定任务类型，再校验参数取值。如果参数与实际任务类型不兼容，任务将触发 异步报错（错误码：InvalidParameter.TaskTypeConstraint）。
  • 显式指定任务类型，即 omni_reference_task_type 为 reference、edit 或 extend：接口在提交任务时提前校验对应任务的特殊参数限制。不符合要求时，接口立即报错，任务不会创建。

可选值：

  • 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
resolution string  |  视频分辨率

视频分辨率。可选值：480p、720p、1080p、4k。

模型支持：

  • 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.0 pro：默认值 1080p；可选值 480p、720p、1080p
  • Seedance 1.0 pro fast：默认值 1080p；可选值 480p、720p、1080p
ratio string  |  视频宽高比

生成视频的宽高比例。

  • 可选值：16:9、4:3、1:1、3:4、9:16、21:9、adaptive（根据任务类型和输入内容自动适配宽高比）
不同模型的取值限制和 adaptive 适配规则

任务类型 Seedance 2.5 Seedance 2.0 系列 Seedance 1.0 系列
文生视频 支持在可选宽高比中自行设置，或由模型根据提示词在可选宽高比中自动选择
支持 adaptive 或指定宽高比		 支持在可选宽高比中自行设置，或由模型根据提示词在可选宽高比中自动选择
支持 adaptive 或指定宽高比		 仅支持在可选宽高比中自行设置
不支持 adaptive
首帧或首尾帧生视频 自动保持输出视频宽高比和 first_frame 指定的首帧图片一致
默认且仅支持 adaptive		 支持在可选宽高比中自行设置，或由模型根据首帧图在可选宽高比中自动选择
支持 adaptive 或指定宽高比		 支持在可选宽高比中自行设置，或由模型根据首帧图在可选宽高比中自动选择
支持 adaptive 或指定宽高比
全模态参考生视频 视频编辑 / 视频延长 模型根据提示词意图选定待编辑视频或待延长视频，并自动保持输出视频宽高比和待编辑视频或待延长视频一致，不支持另行设置
默认且仅支持 adaptive		 支持在可选宽高比中自行设置，或由模型根据待编辑视频或待延长视频在可选宽高比中自动选择
支持 adaptive 或指定宽高比		 —
参考生视频 支持在可选宽高比中自行设置，或由模型根据提示词在可选宽高比中自动选择
支持 adaptive 或指定宽高比		 支持在可选宽高比中自行设置，或由模型根据提示词在可选宽高比中自动选择
支持 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/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 16:9 — 3840×2160 —
4:3 — 3326×2494 —
1:1 — 2880×2880 —
3:4 — 2494×3326 —
9:16 — 2160×3840 —
21:9 — 4398×1886 —

模型支持：

  • Seedance 2.5：默认值 adaptive
  • Seedance 2.0 系列：默认值 adaptive
  • Seedance 1.0 pro：文生视频默认 16:9，图生视频默认 adaptive
  • Seedance 1.0 pro fast：文生视频默认 16:9，图生视频默认 adaptive
duration integer  |  视频时长

生成视频时长（单位：秒）。

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

不同模型的 duration = -1 适配规则

当 duration 设置为 -1 时，实际生成视频的时长可通过 查询视频生成任务 API 返回的 duration 字段获取。视频时长与计费相关，请谨慎设置。

模型 duration = -1取值规则
Seedance 2.0 系列 模型在 duration 的有效取值范围内，自主选择合适的视频长度（整数秒）。
Seedance 2.5（视频编辑任务） 模型根据提示词意图选定待编辑视频，并自动保持输出视频时长和待编辑视频基本一致，不支持另行设置。
输出时长可能为非整数秒
输出时长可能略短于待编辑视频，误差约 0.4 秒
Seedance 2.5（其他任务类型） 模型在 duration 的有效取值范围内，自主选择合适的视频长度（整数秒）。

模型支持：

  • Seedance 2.5：默认值 -1；取值范围 [4, 30]；或设置为 -1（智能选择）
  • Seedance 2.0 系列：取值范围 [4, 15]；或设置为 -1（智能选择）
  • Seedance 1.0 pro：取值范围 [2, 12]
  • Seedance 1.0 pro fast：取值范围 [2, 12]
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 系列
watermark boolean 默认值 false  |  视频水印

生成视频是否包含水印。

  • true：生成视频右下角会展示 AI 生成 水印。
  • false：生成视频不含水印。
output_formatnew string 默认值 mp4  |  输出格式

输出视频的格式。

  • mp4：通用格式，兼容性最好，采用标准色彩精度，可在网页、移动端、各类播放器及分发平台直接播放。
  • mov：面向专业场景的高色彩精度格式，更好地保持画面色彩与亮度一致性、适用于调色、抠像、合成等对色彩还原要求高的专业后期加工。推荐在视频编辑、视频延长场景使用 mov 格式作为输入和输出。

模型支持：

  • Seedance 2.5
seed integer 默认值 -1  |  随机种子

种子整数，用于控制生成内容的随机性。-1 表示使用随机数替代。

取值范围：[-1, 2147483647]

模型支持：

  • Seedance 1.0 pro
  • Seedance 1.0 pro fast
camera_fixed boolean 默认值 false  |  固定摄像头

是否固定摄像头。

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

参考图场景不支持。

模型支持：

  • Seedance 1.0 pro
  • Seedance 1.0 pro fast
return_last_frame boolean 默认值 false  |  返回尾帧

是否返回生成视频的尾帧图像。

  • true：返回生成视频的尾帧图像，可通过 查询视频生成任务接口 获取，尾帧图像的格式为 jpeg，宽高像素值与生成的视频保持一致，无水印。
  • false：不返回生成视频的尾帧图像。

使用该参数可实现生成多个连续视频：以上一个生成视频的尾帧作为下一个视频任务的首帧，快速生成多个连续视频，调用示例详见 教程。

draft boolean 默认值 false  |  样片模式

控制是否开启样片模式。阅读文档 获取使用教程和注意事项。

  • true：开启样片模式，生成一段预览视频，用于确认场景结构、镜头调度、主体动作与 Prompt 意图是否符合预期。
  • false：关闭样片模式，正常生成一段视频。

模型支持：

  • Seedance 2.5
service_tier string 默认值 default  |  服务等级

指定处理本次请求的服务等级类型。

  • default：在线推理模式，RPM 和并发数配额较低（详见 模型列表），适合对推理时效性要求较高的场景。
  • flex：离线推理模式，TPD 配额更高（详见 模型列表），价格为在线推理的 50%，适合对推理时延要求不高的场景。Seedance 2.5、Seedance 2.0 系列暂不支持。

模型支持：

  • Seedance 1.0 pro
  • Seedance 1.0 pro fast
callback_url string  |  回调地址

填写本次生成任务结果的回调通知地址。当视频生成任务有状态变化时，方舟将向此地址推送 POST 请求，请求内容结构与 查询任务 API 的返回体一致。

execution_expires_after integer 默认值 172800  |  任务超时阈值

任务超时阈值。指定任务提交后的过期时间（单位：秒），从 created_at 时间戳开始计算，默认 48 小时。

超过该时间后任务会被自动终止，并标记为 expired 状态。

不论使用哪种 service_tier，都建议根据业务场景设置合适的超时时间。

取值范围：[3600, 259200]

priority integer 默认值 0  |  执行优先级

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

默认情况下，请求按 FIFO（First In, First Out，先进先出）顺序执行；设置较高优先级后，该请求将插队到同 Endpoint（推理接入点）下所有低优先级请求之前。

示例：某 Endpoint 当前队列中有 3 个排队中（status=queued）任务，优先级均为 0（默认）：

队列：[任务 A: priority=0] → [任务 B: priority=0] → [任务 C: priority=0]

此时提交一个 priority=5 的新请求，该请求将直接排到队首：

队列：[新请求: priority=5] → [任务 A: priority=0] → [任务 B: priority=0] → [任务 C: priority=0]

取值范围：[0, 9]

模型支持：

  • Seedance 2.5
  • Seedance 2.0 系列
safety_identifier string  |  用户标识

终端用户的唯一标识符，用于协助平台检测您的应用中可能违反火山方舟使用政策的用户。该标识符为英文字符串，需保证对单个用户固定且唯一，长度不超过 64 个字符。

推荐传入对用户名、用户 ID 或邮箱进行哈希处理后生成的字符串，避免泄露用户隐私信息。

tools object[]  |  工具配置

配置模型要调用的工具。

模型支持：

  • Seedance 2.5
  • Seedance 2.0 系列
type string 必选  |  工具类型

tools.type

指定使用的工具类型。

  • web_search：联网搜索工具。开启联网搜索后，模型会根据用户的提示词自主判断是否搜索互联网内容（如商品、天气等）。可提升生成视频的时效性，但也会增加一定的时延。阅读教程 获取详细代码示例。

响应参数#

id string  |  任务 ID

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

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

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