跳转到主要内容
POST
  • 请求体与 火山方舟视频生成 API 官方格式一致。素材上限、时长和任务类型与 Seedance 2.5 相同,并开放全部输出分辨率。
  • 支持样片模式:先用 480p 低成本出一段样片,确认画面、运镜、动作和对提示词的理解后,再基于这段样片出 1080p 正式片。正式片和样片画面基本一致。
  • 异步接口:提交后立即返回任务 id,再调用 查询视频任务 获取结果。
  • 计费与时长、分辨率、是否包含参考视频相关,见 模型价格。任务失败自动退款。

模型

可用模型以 模型广场 为准。

分辨率

1080p 使用 10bit 位深和 H.265/HEVC 编码,色彩层次更细。少数播放器无法解码时,换用 VLC、MPV 或 QuickTime Player。
直接生成任意一档时,省略 draft,或传 "draft": false。两步样片流程见 样片模式。

鉴权

string
必填
Bearer <API Key>。在 API 密钥 页面创建。

请求参数

string
必填
模型 ID:Doubao-Seedance-2.5-full。
array
必填
输入内容数组。直接生成时,每一项的结构与 Seedance 2.5 相同。样片转正式片时,数组里只放一个 draft_task。
string
默认值:"720p"
分辨率:480p、720p 或 1080p。样片模式另有限制,见 样片模式。
string
默认值:"adaptive"
宽高比:16:9、4:3、1:1、3:4、9:16、21:9,或 adaptive。首帧 / 首尾帧、视频编辑、视频延长任务只能使用 adaptive。
integer
默认值:"5"
视频时长(秒),取值 4~30。传 -1 时由模型自动决定时长,提交时按 30 秒上限预扣费用,完成后按实际结果结算。视频编辑任务只能使用 -1。
boolean
默认值:"true"
是否生成与画面同步的音频。
boolean
默认值:"false"
是否开启样片模式。仅 Doubao-Seedance-2.5-full 支持。true 时 resolution 必须是 480p,其他分辨率返回 400。
integer
随机种子,取值 -1 到 2^32-1。
boolean
默认值:"false"
是否添加「AI 生成」水印。
boolean
默认值:"false"
是否额外返回视频最后一帧的图片,用于连续生成。
string
默认值:"mp4"
输出格式:mp4 或 mov。mov 面向调色、抠像等后期,部分播放器无法直接播放。
array
增强工具。目前支持联网搜索:[{"type": "web_search"}]。

素材要求

任务类型与限制

模型会根据参考素材和提示词意图判断任务类型。视频编辑、视频延长和首尾帧任务对参数有硬性要求,不满足时任务会在执行阶段失败(费用自动退回)。

样片模式

只有 Doubao-Seedance-2.5-full 支持。适合要反复尝试的镜头:不满意的样片直接丢掉,只为选中的那一条付 1080p 的费用。样片按 480p 计费,正式片按 1080p 另行计费。 普通 480p 任务不能当作样片。创建时要带 "draft": true。

第 1 步:出样片

正常提交,加 "draft": true,resolution 必须是 480p(其他分辨率返回 400):
样片生成完成(查询结果 status 为 SUCCESS)后,记下 data.task.id(cgt- 开头的样片号),第 2 步要用。这时 data.task.draft 为 true。
上例里第 2 步要填的是 cgt-20261008150427-s4l8g,不是外层 task_id。

第 2 步:用样片出正式片

content 里只放一个 draft_task,resolution 填 1080p:
draft_task.id 填样片的 data.task.id(cgt-…),不是 task_id(例如 b2028cb5-663b-4a43-9760-2cf73bccd3f2)。填 UUID 会返回 400。样片必须已经完成(status 为 SUCCESS)。样片号自创建起 7 天内有效。

提交响应

与 Seedance 2.0 相同:返回 object 为 video、status 为 queued 的任务对象,用其中的 id 查询结果。

使用示例

多图参考

视频编辑

480p 直接生成