Seedance 2.5 创建视频（平台格式）

支持文本、图片、视频和音频参考输入，可用于文生视频、首帧或首尾帧生视频、多模态参考生成、视频编辑和视频延长。

如需直接使用火山方舟请求结构，请参阅原生格式创建接口。

先生成低分辨率样片、确认效果后再制作正式视频，请参阅 Draft 样片生成指南。样片使用 480p，基于样片生成的正式视频使用 1080p。

POST/v1/video/generations

使用平台 Video Generations 路径创建 Seedance 2.5 异步视频任务。接口返回任务对象和用于查询结果的任务 ID。

Seedance 2.5 支持最长 30 秒的视频、最多 50 个多模态参考素材，以及 mp4 和 mov 输出。视频编辑任务的 ratio 必须为 adaptive，duration 必须为 -1。

Authorization

bearerAuth

AuthorizationBearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

In: header

Request Body

application/json

Seedance 2.5 视频生成参数。不同任务类型对素材角色、宽高比和时长有不同约束。

TypeScript Definitions

Use the request body type in TypeScript.

model*string

Seedance 2.5 模型 ID，例如 doubao-seedance-2-5-260628。实际调用请以当前 API Key 可见模型为准。

Length1 <= length

content*array<|>

输入内容列表，支持文本、图片、视频、音频或 Draft 任务 ID。多模态参考最多使用 50 个素材，包括 30 张图片、10 段视频和 10 段音频；视频和音频单段为 2～30 秒，同类素材总时长不超过 30 秒。视频编辑的参考视频须为 4～30 秒。支持纯音频参考；首帧、首尾帧模式不能与多模态参考模式混用。

提示词可使用 @图像1、@视频1、@音频1 等方式引用数组中对应顺序的素材。

Items1 <= items

draft?boolean

是否生成 Draft 样片。设为 true 时必须使用 480p；样片成功后可在七天内通过 content.draft_task.id 生成 1080p 正式视频。正式生成时省略此字段或设为 false。

omni_reference_task_type?string

全模态参考任务类型。auto 自动判定；reference 参考生成；edit 视频编辑，须包含参考视频且 ratio=adaptive、duration=-1；extend 视频延长，须包含参考视频且 ratio=adaptive。显式指定类型会提前校验对应限制，提示词意图仍需与所选类型一致。

Default"auto"

Value in

"auto"
"reference"
"edit"
"extend"

generate_audio?boolean

是否生成与画面匹配的音频。启用后通常会增加生成耗时和计费成本。

ratio?string

视频宽高比。文生视频和多模态参考生视频可指定比例或使用 adaptive；首帧、首尾帧、视频编辑和视频延长任务仅支持 adaptive。

Default"adaptive"

Value in

"16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive"

duration?|integer

生成时长，单位为秒。支持 4 到 30，或传 -1 由模型自动决定。视频编辑任务仅支持 -1，视频延长支持 4 到 30 或 -1。

Default-1

resolution?string

输出视频的分辨率。支持 480p、720p 和 1080p；实际输出像素尺寸由分辨率、宽高比和当前模型能力共同决定。

Default"720p"

Value in

"480p"
"720p"
"1080p"

output_format?string

输出视频格式。mp4 适合网页与常规分发；mov 使用 H.264、YUV444P 和 PCM，适合调色、抠像与合成等后期场景。

Default"mp4"

Value in

"mp4"
"mov"

watermark?boolean

是否添加水印。是否生效取决于模型权限和服务配置。

seed?integer

随机种子，取值范围为 -1 到 4294967295。相同种子可增强结果的可复现性，但不保证完全一致。

Range-1 <= value <= 4294967295

return_last_frame?boolean

是否在任务结果中返回无水印 JPEG 尾帧图像，可用于连续视频生成。

callback_url?string

任务完成后的回调地址。未配置时可以通过查询接口轮询任务状态。

Formaturi

safety_identifier?string

终端用户的稳定唯一标识，用于协助识别可能违反使用政策的用户。建议传入用户名、用户 ID 或邮箱经哈希处理后的字符串，避免提交个人信息。

Length1 <= length <= 64

execution_expires_after?integer

任务从创建开始的有效时间，单位为秒。超过该时间后，仍未完成的任务将进入过期状态。

Formatint32

Range3600 <= value <= 259200

Default172800

tools?array<>

模型可以调用的工具列表，例如 web_search。可用工具及具体参数取决于当前账户权限。

service_tier?string

服务等级。Seedance 2.5 使用 default 在线推理，不支持 flex。排队优先级通过独立的 priority 参数设置。

Default"default"

priority?integer

同一推理接入点内的排队优先级，取值 0～9，数值越大越优先；同优先级按提交顺序处理，不中断正在运行的任务。

Range0 <= value <= 9

Default0

[key: string]?any

Response Body

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "content": [      {        "type": "text",        "text": "一只白色小兔子乘着纸飞机穿过云层，电影感光影，镜头平稳推进"      }    ],    "generate_audio": true,    "ratio": "16:9",    "duration": 10,    "resolution": "1080p",    "output_format": "mp4",    "watermark": false  }'

{
  "id": "task_xxxxx",
  "task_id": "task_xxxxx",
  "object": "video",
  "model": "MODEL_ID",
  "status": "queued",
  "progress": 0,
  "created_at": 1786082400
}

火山方舟创建视频生成任务官方文档查看 Seedance 视频生成任务的上游协议定义与最新字段变化。

Seedance 2.5 创建视频（平台格式）

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

402application/json

429application/json

500application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`