跳转到主要内容
POST
  • 请求体与 火山方舟视频生成 API 官方格式一致:文本、图片、视频、音频都放在 content 数组中,用 role 区分用途。素材角色和参数限制与 Seedance 2.0 相同,并开放对应版本的全部输出分辨率。
  • 样片模式请使用 Seedance 2.5 Full。
  • 异步接口:提交后立即返回任务 id,再调用 查询视频任务 获取结果。
  • 计费与时长、分辨率、是否包含参考视频相关,见 模型价格。任务失败自动退款。

模型

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

分辨率

4k 使用 10bit 位深和 H.265/HEVC 编码。少数播放器无法解码时,换用 VLC、MPV 或 QuickTime Player。

鉴权

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

请求参数

string
必填
模型 ID:Doubao-Seedance-2.0-full、Doubao-Seedance-2.0-fast-full 或 Doubao-Seedance-2.0-mini-full。
array
必填
输入内容数组,可以包含文本、图片、视频、音频。
string
默认值:"720p"
分辨率:480p、720p、1080p 或 4k。Doubao-Seedance-2.0-fast-full 和 Doubao-Seedance-2.0-mini-full 仅支持 480p 和 720p。
string
默认值:"16:9"
宽高比:16:9、4:3、1:1、3:4、9:16、21:9,或 adaptive(根据输入图片 / 视频自动匹配)。
integer
默认值:"5"
视频时长(秒),取值 4~15。传 -1 时由模型自动决定时长,提交时按上限预扣费用,完成后按实际结果结算。
boolean
默认值:"true"
是否生成与画面同步的音频(人声、音效、背景音乐)。
integer
随机种子,取值 -1 到 2^32-1。相同请求和种子会生成相似结果,但不保证完全一致。
boolean
默认值:"false"
是否在视频中添加「AI 生成」水印。
boolean
默认值:"false"
是否额外返回视频最后一帧的图片,可以作为下一段视频的首帧,实现连续生成。
array
增强工具。目前支持联网搜索:[{"type": "web_search"}],生成时参考网络上的实时信息。
  • 使用首帧 / 尾帧时,不能同时传参考视频或参考音频。
  • 参考音频不能单独使用,必须搭配参考图或参考视频。
  • 真人人脸作为参考素材时可能会被上游内容审核拦截。
提交阶段的错误返回 {"code": "...", "message": "...", "data": null} 结构。HTTP 状态码为 429 时,message 为「当前分组上游负载已饱和,请稍后再试」,请退避后重试。

提交响应

string
任务 ID,用于 查询视频任务。
string
与 id 相同,为兼容旧接口保留。
string
固定为 video。
string
请求的模型 ID。
string
固定为 queued。
integer
固定为 0。
integer
提交时间,Unix 时间戳(秒)。

使用示例

4k

480p

图生视频(首帧)

多模态参考(图片 + 视频 + 音频)