跳转到主要内容
POST

认证

Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

请求参数

model
string
必填
视频生成模型名称支持的模型:
  • doubao-seedance-2.0 - 标准版,支持文生视频、图生视频、首尾帧视频、参考视频、参考音频、有声视频
  • doubao-seedance-2.0-fast - 快速版,功能与标准版一致,生成速度更快
  • doubao-seedance-2.0-mini - 迷你版,功能与标准版一致
prompt
string
视频内容描述文生视频时必填,图生视频/视频参考生视频时可选建议明确主体、动作、镜头和风格,以获得更好的生成效果
  • 提示词限制输入 4000 个字符,但是建议输入 500 字符。
  • 模型 doubao-seedance-2.0-mini 没有字数限制。建议:中文提示词不超过500字,英文提示词不超过1000词。字数过多易导致信息分散,模型可能忽略细节、 仅关注重点,进而造成视频缺失部分元素。
示例:"小猫对着镜头打哈欠"
duration
integer
默认值:"5"
视频时长(秒)支持范围:4 ~ 15默认值:5
size
string
默认值:"16:9"
视频宽高比可选值:
  • 16:9 - 横屏
  • 9:16 - 竖屏
  • 1:1 - 方形
  • 4:3 - 传统比例
  • 3:4 - 竖向传统比例
  • 21:9 - 超宽屏
  • adaptive - 自适应(根据输入图片/视频自动匹配)
默认值:16:9
resolution
string
默认值:"720p"
视频分辨率可选值:
  • 480p - 标清
  • 720p - 高清
  • 1080p - 全高清(仅 doubao-seedance-2.0 支持)
  • 4k - 超高清(仅 doubao-seedance-2.0 支持)
默认值:720p
seed
integer
随机种子,用于控制生成内容的随机性
  • 相同的请求下,模型收到不同的 seed 值,将生成不同的结果
  • 相同的请求下,模型收到相同的 seed 值,会生成类似的结果,但不保证完全一致
generate_audio
boolean
默认值:"true"
是否生成音频(有声视频)设置为 true 时,视频将包含 AI 生成的配套音频设置为 false 时,视频将不包含音频(无声视频)默认值:true
return_last_frame
boolean
默认值:"false"
是否返回尾帧图片设置为 true 时,任务结果中会额外返回视频最后一帧的图片 URL,可用于连续视频生成默认值:false
tools
array<object>
工具列表,用于联网搜索等增强能力示例:[{"type": "web_search"}]
image_urls
array<string>
图片 URL 数组,用于图生视频支持两种格式:
  • 普通图片 URL:https://example.com/cat.jpg
  • Asset URL(审核通过的素材):asset://asset_a
示例:["https://example.com/cat.jpg"]["asset://asset_a"]
Asset URL 仅支持 doubao-seedance-2.0doubao-seedance-2.0-fast 模型,其他模型不可使用
  • image_urlsimage_with_roles 不能同时使用
  • 最多 9 张参考图
image_with_roles
array
带角色的图片数组,支持指定首帧/尾帧
url 字段使用 Asset URL 时,仅支持 doubao-seedance-2.0doubao-seedance-2.0-fast 模型,其他模型不可使用
示例:
Asset URL 写法:
  • image_urlsimage_with_roles 不能同时使用
  • 使用首尾帧图片时,video_urlsaudio_urls 不可用
video_urls
array<string>
参考视频 URL 数组支持两种格式:
  • 普通视频 URL:https://example.com/reference.mp4
  • Asset URL(审核通过的素材):asset://asset_a
示例:["https://example.com/reference.mp4"]["asset://asset_a"]
Asset URL 仅支持 doubao-seedance-2.0doubao-seedance-2.0-fast 模型,其他模型不可使用
  • 使用首帧/尾帧图片(image_with_roles)时,参考视频不可用
  • 最多 3 个参考视频,1.8s < 总时长 < 15.2s
  • 参考视频分辨率需要在 480P ~ 720P 之间
  • 参考视频不可出现真人
audio_urls
array<string>
参考音频 URL 数组支持两种格式:
  • 普通音频 URL:https://example.com/speech.wav
  • Asset URL(审核通过的素材):asset://asset_a
示例:["https://example.com/speech.wav"]["asset://asset_a"]
Asset URL 仅支持 doubao-seedance-2.0doubao-seedance-2.0-fast 模型,其他模型不可使用
  • 使用首帧/尾帧图片(image_with_roles)时,参考音频不可用
  • 最多 3 个参考音频,总时长 ≤ 15s
  • 参考音频需与参考图片或者参考视频使用

响应

code
integer
响应状态码,成功时为 200
data
array
返回数据数组

使用场景

场景 1:文生视频

场景 2:图生视频(首帧)

场景 3:首尾帧视频

场景 4:视频参考生视频

场景 5:参考视频 + 参考音频

场景 6:有声视频

场景 7:连续视频生成(返回尾帧)

场景 8:快速版生成

场景 9:参考图片 + 参考视频 + 参考音频(多模态视频)

结合参考图片、参考视频和参考音频,生成沉浸式第一人称视角广告视频。适用于产品宣传、品牌广告等需要多素材融合的场景。

场景 10:使用 Asset URL 图生视频

审核通过的虚拟人像素材可直接作为参考图片传入,无需重新上传和审核。

场景 11:使用 Asset URL 指定参考人像(image_with_roles)

场景 12:快速版 + Asset URL 图生视频

场景 13:Asset URL 图片 + 参考视频(动作迁移)

将审核通过的人像素材与参考视频结合,驱动人物完成指定动作。
查询任务结果视频生成为异步任务,提交后会返回 task_id。使用 获取任务状态 接口查询生成进度和结果。

与 1.5 Pro 版本的差异