创建视频生成任务

POST/api/v3/contents/generations/tasks

提交视频生成任务。模型会依据传入的图片及文本信息生成视频，待生成完成后，您可以按条件查询任务并获取生成的视频。

说明

本接口为异步接口：提交后仅返回任务 ID，需调用查询视频生成任务轮询任务状态，任务成功后从 content.video_url 获取视频。

• 任务 ID 仅保存 7 天（从 created_at 开始计算），超时后将自动清除。
• 视频 URL 有效期为 24 小时，请及时下载或转存。
• Seedance 2.5 模型生成的产物 URL 下载次数上限为 100 次。

模型选择

视频生成支持以下模型，model 填写下表左侧的模型 ID。

模型 ID	说明
doubao-seedance-2-5	生成质量最高，支持样片模式、视频编辑与视频延长
doubao-seedance-2-0	质量与成本兼顾，支持 4k 输出
doubao-seedance-2-0-fast	生成速度优先，最高 720p
doubao-seedance-2-0-mini	成本最低，适合大批量生成，最高 720p
doubao-seedance-1-0-pro	上一代模型，支持 frames、seed、camera_fixed 与离线推理
doubao-seedance-1-0-pro-fast	上一代模型，生成速度优先

不同模型的输出规格与能力存在差异，选择模型后请先确认参数是否在其支持范围内：

模型 ID	resolution	duration	独有能力
doubao-seedance-2-5	480p、720p、1080p	[4, 30]，默认 -1	draft 样片、output_format 可选 mov、音频可单独传入
doubao-seedance-2-0	480p、720p、1080p、4k	[4, 15]	4k 输出
doubao-seedance-2-0-fast	480p、720p	[4, 15]	—
doubao-seedance-2-0-mini	480p、720p	[4, 15]	—
doubao-seedance-1-0-pro	480p、720p、1080p	[2, 12]	frames、seed、camera_fixed、service_tier 离线推理
doubao-seedance-1-0-pro-fast	480p、720p、1080p	[2, 12]	同上

模型差异

• draft、output_format、omni_reference_task_type 以及单独传入音频仅 doubao-seedance-2-5 支持。
• 首帧、首尾帧与视频编辑任务中，doubao-seedance-2-5 的 ratio 仅支持 adaptive；2.0 系列及更早模型可以指定具体比例。
• 离线推理（service_tier 设为 flex）仅 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]。若参数填写错误，该参数将被忽略或触发报错。

content 支持的组合

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

图生视频-首帧、图生视频-首尾帧、全模态参考生视频（包括参考图、视频、音频）为 3 种互斥场景，不可混用。

参考素材要求

图片：格式 jpeg、png、webp、bmp、tiff、gif，Seedance 2.0 系列及以上额外支持 heic、heif；宽高比 [0.4, 2.5]；宽高长度 [300, 6000] px；单张小于 30 MB。图片数量：图生视频-首帧 1 张，图生视频-首尾帧 2 张，Seedance 2.5 全模态参考生视频 1-30 张，Seedance 2.0 系列 1-9 张。

视频：格式 mp4、mov；分辨率 480p、720p、1080p、4k；单视频不超过 200 MB；帧率 [24, 60] FPS。时长：Seedance 2.5 非视频编辑任务 [2, 30] s、视频编辑任务 [4, 30] s，最多 10 个参考视频、总时长不超过 30 s；Seedance 2.0 系列单视频 [2, 15] s，最多 3 个参考视频、总时长不超过 15 s。

音频：格式 wav、mp3；单个不超过 15 MB。时长：Seedance 2.5 单个 [2, 30] s，最多 10 段、总时长不超过 30 s；Seedance 2.0 系列单个 [2, 15] s，最多 3 段、总时长不超过 15 s。

请求体大小不超过 64 MB，大文件请勿使用 Base64 编码。

真人素材

Seedance 2.5、Seedance 2.0 系列模型不支持直接上传含有真人人脸的参考图 / 视频。可使用部分模型的含人脸原始产物、预置虚拟人像，或已授权真人素材作为输入。

duration 与 ratio 的模型限制

duration 设置为 -1 时，实际生成视频的时长可通过查询视频生成任务接口返回的 duration 字段获取。Seedance 2.5 在视频编辑任务中仅支持 duration = -1，输出时长与待编辑视频基本一致，且 ratio 必须为 adaptive；Seedance 2.5 在首帧 / 首尾帧生视频任务中，ratio 默认且仅支持 adaptive。视频时长与计费相关，请谨慎设置。

鉴权

通过 Bearer Token 认证，请求头格式为 Authorization: Bearer YOUR_API_KEY。

Authorizationstring必填

API Key，格式为 Bearer YOUR_API_KEY。

默认值：-

Content-Typestring必填

请求体格式。

默认值：application/json

Request-Idstring可选

客户侧生成的唯一请求标识，用于追踪和排查。

默认值：-

请求参数

Body 参数

modelstring必填

您需要调用的模型的 ID（Model ID）。开通模型服务后可查询 Model ID。也可通过 Endpoint ID 调用模型，获得限流、计费类型、运行状态查询、监控、安全等高级能力。

默认值：-

contentobject[]必填

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

默认值：-

content.typestring必填

输入内容的类型：`text` 文本信息、`image_url` 图片信息、`video_url` 视频信息、`audio_url` 音频信息、`draft_task` 样片信息。

默认值：-

content.textstring必填

`content.type` 为 `text` 时必填。输入给模型的文本提示词，描述期望生成的视频。中文提示词建议不超过 500 字，英文提示词建议不超过 1000 词。

默认值：-

content.image_urlobject必填

`content.type` 为 `image_url` 时必填。输入给模型的图片对象。

默认值：-

content.image_url.urlstring必填

图片来源，支持图片公网 URL、图片 Base64 编码（`data:image/<图片格式>;base64,<Base64 编码>`）与素材 ID（`asset://<ASSET_ID>`）。

默认值：-

content.video_urlobject必填

`content.type` 为 `video_url` 时必填。输入给模型的视频对象。

默认值：-

content.video_url.urlstring必填

视频来源，支持视频公网 URL 与素材 ID（`asset://<ASSET_ID>`）。

默认值：-

content.audio_urlobject必填

`content.type` 为 `audio_url` 时必填。输入给模型的音频对象。

默认值：-

content.audio_url.urlstring必填

音频来源，支持音频公网 URL、音频 Base64 编码（`data:audio/<音频格式>;base64,<Base64 编码>`）与素材 ID（`asset://<ASSET_ID>`）。

默认值：-

content.draft_taskobject必填

`content.type` 为 `draft_task` 时必填。输入给模型的样片任务对象。

默认值：-

content.draft_task.idstring必填

样片任务 ID，即生成 Draft 视频时返回的任务 ID。有效期 7 天（从 `created_at` 开始计算），超时后无法再用于生成正式视频。

默认值：-

content.rolestring可选

图片、视频、音频的位置或用途。图片：`first_frame` 首帧、`last_frame` 尾帧、`reference_image` 参考图；视频：`reference_video`；音频：`reference_audio`。

默认值：-

omni_reference_task_typestring可选

任务类型引导，用于在提交时提前校验对应任务类型的参数限制。可选值：`auto` 由模型自动判定；`reference` 参考生视频；`edit` 视频编辑；`extend` 视频延长。模型支持：`Seedance 2.5`。

默认值：auto

resolutionstring可选

视频分辨率。可选值：`480p`、`720p`、`1080p`、`4k`。`Seedance 2.5` 默认 `720p`，可选 `480p`、`720p`、`1080p`；`Seedance 2.0` 默认 `720p`，可选至 `4k`；`Seedance 1.0 pro` 与 `Seedance 1.0 pro fast` 默认 `1080p`。

默认值：-

ratiostring可选

生成视频的宽高比例。可选值：`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`adaptive`（根据任务类型和输入内容自动适配）。`Seedance 2.5` 与 `Seedance 2.0 系列` 默认 `adaptive`。

默认值：-

durationinteger可选

生成视频时长，单位：秒。`duration` 与 `frames` 二选一，`frames` 优先级更高。`Seedance 2.5` 默认 `-1`，取值范围 `[4, 30]`；`Seedance 2.0 系列` 取值范围 `[4, 15]`；`Seedance 1.0 系列` 取值范围 `[2, 12]`。设置为 `-1` 表示由模型智能选择时长。

默认值：-

framesinteger可选

生成视频的帧数，用于生成小数秒的视频。取值范围 `[29, 289]`，支持满足 `25 + 4n` 格式的整数值。`duration` 与 `frames` 二选一，`frames` 优先级更高。模型支持：`Seedance 1.0 pro`、`Seedance 1.0 pro fast`。

默认值：-

generate_audioboolean可选

控制生成的视频是否包含与画面同步的声音。`true`：包含同步音频，模型会基于提示词与视觉内容自动生成人声、音效及背景音乐；`false`：输出无声视频。生成的有声视频均为单声道。模型支持：`Seedance 2.5`、`Seedance 2.0 系列`。

默认值：true

watermarkboolean可选

生成视频是否包含水印。`true`：生成视频右下角展示「AI 生成」水印；`false`：不含水印。

默认值：false

output_formatstring可选

输出视频的格式。`mp4` 兼容性最好，可在网页、移动端及各类播放器直接播放；`mov` 面向专业后期加工场景。推荐在视频编辑、视频延长场景使用 `mov`。模型支持：`Seedance 2.5`。

默认值：mp4

seedinteger可选

用于控制生成内容随机性的种子整数，`-1` 表示使用随机数替代。相同 `seed` 会生成类似结果，但不保证完全一致。取值范围 `[-1, 2147483647]`。模型支持：`Seedance 1.0 pro`、`Seedance 1.0 pro fast`。

默认值：-1

camera_fixedboolean可选

是否固定摄像头。`true` 时平台会在提示词中追加固定摄像头，实际效果不保证。参考图场景不支持。模型支持：`Seedance 1.0 pro`、`Seedance 1.0 pro fast`。

默认值：false

return_last_frameboolean可选

是否返回生成视频的尾帧图像。`true` 时可通过查询视频生成任务接口获取，尾帧格式为 `jpeg`，宽高像素值与视频一致，无水印。可用于以上一个视频的尾帧作为下一个视频的首帧，生成多个连续视频。

默认值：false

draftboolean可选

是否开启样片模式。`true` 生成一段预览视频，用于确认场景结构、镜头调度、主体动作与 Prompt 意图是否符合预期，仅支持 `480p` 分辨率（使用其他分辨率会报错）；`false` 正常生成视频。模型支持：`Seedance 2.5`。

默认值：false

service_tierstring可选

指定处理本次请求的服务等级。`default`：在线推理模式；`flex`：离线推理模式，价格为在线推理的 50%，`Seedance 2.5`、`Seedance 2.0 系列` 暂不支持。不支持修改已提交任务的服务等级。模型支持：`Seedance 1.0 pro`、`Seedance 1.0 pro fast`。

默认值：default

callback_urlstring可选

本次生成任务结果的回调通知地址。当视频生成任务有状态变化时，方舟将向此地址推送 POST 请求，请求内容结构与查询任务接口的返回体一致。调用失败（5 秒内未接收到成功发送的信息）会回调三次。

默认值：-

execution_expires_afterinteger可选

任务超时阈值，即任务提交后的过期时间，单位：秒，从 `created_at` 开始计算，默认 48 小时。超过该时间后任务会被自动终止并标记为 `expired`。取值范围 `[3600, 259200]`。

默认值：172800

priorityinteger可选

当前请求的执行优先级，决定其在队列中的排序位置，数值越大优先级越高。仅影响排队顺序，不会中断正在执行中的任务；仅在同一 Endpoint 内生效。取值范围 `[0, 9]`。模型支持：`Seedance 2.5`、`Seedance 2.0 系列`。

默认值：0

safety_identifierstring可选

终端用户的唯一标识符，用于协助平台检测可能违反使用政策的用户。需为英文字符串，对单个用户固定且唯一，长度不超过 64 个字符。推荐传入对用户名、用户 ID 或邮箱哈希后的字符串。

默认值：-

toolsobject[]可选

配置模型要调用的工具。模型支持：`Seedance 2.5`、`Seedance 2.0 系列`。

默认值：-

tools.typestring必填

指定使用的工具类型。`web_search`：联网搜索工具，开启后模型会根据提示词自主判断是否搜索互联网内容，可提升生成视频的时效性，但也会增加一定时延。

默认值：-

响应参数

idstring可选

视频生成任务 ID。仅保存 7 天（从 `created_at` 开始计算），超时后将自动清除。设置 `"draft": true` 时为 Draft 视频任务 ID，设置 `"draft": false` 时为正常视频任务 ID。

默认值：-

相关

• 查询视频生成任务 - 轮询任务状态并获取视频地址

请求示例POST

curl __DOCS_API_ORIGIN__/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5",
    "content": [
      {
        "type": "text",
        "text": "小猫对着镜头打哈欠"
      },
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/first-frame.png" },
        "role": "first_frame"
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true
  }'

响应示例200

{
  "id": "cgt-2026****-****"
}