Skip to main content
POST
  • 请求体与 火山方舟视频生成 API 官方格式一致:文本、图片、视频、音频都放在 content 数组中,用 role 区分用途。
  • 异步接口:提交后立即返回任务 id,再调用 查询视频任务 获取结果。
  • 计费与时长、分辨率、是否包含参考视频相关,见 模型价格。任务失败自动退款。

模型

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

鉴权

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

请求参数

string
必填
模型 ID:doubao-seedance-2-0-260128 或 doubao-seedance-2-0-fast-260128。
array
必填
输入内容数组,可以包含文本、图片、视频、音频。
string
默认值:"720p"
分辨率:480p、720p、1080p。快速版不支持 1080p。
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 时间戳(秒)。

使用示例

图生视频(首帧)

首尾帧

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

连续生成(返回尾帧)

任务成功后取出尾帧图片,作为下一个任务的 first_frame 即可续接画面。

联网搜索