获取 API Key 获取 API
文档

doubao-seedance-2.0 视频生成

- 异步处理模式,返回任务ID用于后续查询

  • 支持文生视频、图生视频(首帧/尾帧)
  • 支持参考视频、参考音频、有声视频
  • 支持横屏、竖屏、方形、超宽屏、自适应多种比例

请求示例

curl --request POST \
  --url https://api.openveer.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2.0",
    "prompt": "小猫对着镜头打哈欠",
    "resolution": "720p",
    "size": "16:9",
    "duration": 5,
    "generate_audio": true
  }'

响应示例

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KMCGF6BQGN3X28H3KSR50X5T"
    }
  ]
}

认证

Authorization string

所有接口均需要使用 Bearer Token 进行认证

获取 API Key:

访问 API Key 管理页面 获取您的 API Key

使用时在请求头中添加:

Authorization: Bearer YOUR_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

视频时长(秒)

支持范围:4 \~ 15 秒

默认值:5

size string

视频宽高比

宽高比要在 0.5-2.5 之间

可选值:

  • 16:9 - 横屏
  • 9:16 - 竖屏
  • 1:1 - 方形
  • 4:3 - 传统比例
  • 3:4 - 竖向传统比例
  • 21:9 - 超宽屏
  • adaptive - 自适应(根据输入图片/视频自动匹配)

默认值:16:9

resolution string

视频分辨率

可选值:

  • 480p - 标清
  • 720p - 高清
  • 1080p - 全高清(仅 doubao-seedance-2.0 支持)
  • 4k - 超高清(仅 doubao-seedance-2.0 支持)

默认值:720p

seed integer

随机种子,用于控制生成内容的随机性

注意



* 相同的请求下,模型收到不同的 seed 值,将生成不同的结果

* 相同的请求下,模型收到相同的 seed 值,会生成类似的结果,但不保证完全一致

generate_audio boolean

是否生成音频(有声视频)

设置为 true 时,视频将包含 AI 生成的配套音频

设置为 false 时,视频将不包含音频(无声视频)

默认值:true

return_last_frame boolean

是否返回尾帧图片

设置为 true 时,任务结果中会额外返回视频最后一帧的图片 URL,可用于连续视频生成

默认值:false

tools string
"> 工具列表,用于联网搜索等增强能力 示例:[{"type": "web_search"}]
type string

工具类型

  可选值:

  * web_search - 联网搜索,生成时参考网络信息
image_urls 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.0 和 doubao-seedance-2.0-fast 模型,其他模型不可使用

警告



* image_urls 和 image_with_roles 不能同时使用

* 最多 9 张参考图

image_with_roles array
带角色的图片数组,支持指定首帧/尾帧
注意

url 字段使用 Asset URL 时,仅支持 doubao-seedance-2.0 和 doubao-seedance-2.0-fast 模型,其他模型不可使用

url string

图片 URL 地址

  支持两种格式:

  * 普通图片 URL:https://example.com/day.jpg
  * Asset URL(审核通过的素材):asset://asset_a

  <Note>
    Asset URL 仅支持 doubao-seedance-2.0 和 doubao-seedance-2.0-fast 模型,其他模型不可使用
  </Note>
role string

图片角色

  可选值:

  * first_frame - 首帧图,作为视频起始画面
  * last_frame - 尾帧图,作为视频结束画面
  * reference_image - 参考人像图(配合 Asset URL 使用)
示例:
[
  {"url": "https://example.com/day.jpg", "role": "first_frame"},
  {"url": "https://example.com/night.jpg", "role": "last_frame"}
]
Asset URL 写法:
[
  {"url": "asset://asset_a", "role": "reference_image"}
]
警告
  • image_urls 和 image_with_roles 不能同时使用
    • 使用首尾帧图片时,video_urls 和 audio_urls 不可用
video_urls 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.0 和 doubao-seedance-2.0-fast 模型,其他模型不可使用

警告



* 使用首帧/尾帧图片(image_with_roles)时,参考视频不可用

* 最多 3 个参考视频,1.8s \< 总时长 \< 15.2s

* 参考视频分辨率需要在 480P \~ 720P 之间

audio_urls 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.0 和 doubao-seedance-2.0-fast 模型,其他模型不可使用

警告



* 使用首帧/尾帧图片(image_with_roles)时,参考音频不可用

* 最多 3 个参考音频,总时长 ≤ 15s

* 参考音频需与参考图片或者参考视频使用

响应

code integer

响应状态码,成功时为 200

data array
返回数据数组
status string

任务状态,初始提交时为 submitted

task_id string

任务唯一标识符,用于查询任务状态和结果

使用场景

场景 1:文生视频

{
  "model": "doubao-seedance-2.0",
  "prompt": "小猫对着镜头打哈欠",
  "resolution": "720p",
  "size": "16:9",
  "duration": 5,
  "seed": 42,
  "generate_audio": true
}

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

{
  "model": "doubao-seedance-2.0",
  "prompt": "小猫站起来走向镜头",
  "image_urls": ["https://example.com/cat.jpg"],
  "duration": 5
}

场景 3:首尾帧视频

{
  "model": "doubao-seedance-2.0",
  "prompt": "从白天过渡到夜晚",
  "image_with_roles": [
    {"url": "https://example.com/day.jpg", "role": "first_frame"},
    {"url": "https://example.com/night.jpg", "role": "last_frame"}
  ],
  "duration": 5
}

场景 4:视频参考生视频

{
  "model": "doubao-seedance-2.0",
  "prompt": "将视频风格转换为动漫风格",
  "video_urls": ["https://example.com/reference.mp4"]
}

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

{
  "model": "doubao-seedance-2.0",
  "prompt": "人物说话的场景",
  "video_urls": ["https://example.com/reference.mp4"],
  "audio_urls": ["https://example.com/speech.wav"],
  "size": "16:9",
  "duration": 11
}

场景 6:有声视频

{
  "model": "doubao-seedance-2.0",
  "prompt": "男人叫住女人说:\"你记住,以后不可以用手指指月亮。\"",
  "generate_audio": true
}

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

{
  "model": "doubao-seedance-2.0",
  "prompt": "小猫继续走向镜头",
  "image_urls": ["https://example.com/last_frame_from_prev.png"],
  "return_last_frame": true
}

场景 8:快速版生成

{
  "model": "doubao-seedance-2.0-fast",
  "prompt": "城市夜景延时摄影",
  "size": "21:9",
  "duration": 8
}

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

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

{
  "model": "doubao-seedance-2.0",
  "prompt": "全程使用视频1的第一视角构图,全程使用音频1作为背景音乐。第一人称视角果茶宣传广告,seedance牌「苹苹安安」苹果果茶限定款;首帧为图片1,你的手摘下一颗带晨露的阿克苏红苹果,轻脆的苹果碰撞声;2-4秒:快速切镜,你的手将苹果块投入雪克杯,加入冰块与茶底,用力摇晃,冰块碰撞声与摇晃声卡点轻快鼓点,背景音:「鲜切现摇」;4-6秒:第一人称成品特写,分层果茶倒入透明杯,你的手轻挤奶盖在顶部铺展,在杯身贴上粉红包标,镜头拉近看奶盖与果茶的分层纹理;6-8秒:第一人称手持举杯,你将图片2中的果茶举到镜头前(模拟递到观众面前的视角),杯身标签清晰可见,背景音「来一口鲜爽」,尾帧定格为图片2。背景声音统一为女生音色。",
  "image_urls": [
    "https://example.com/tea_pic1.jpg",
    "https://example.com/tea_pic2.jpg"
  ],
  "video_urls": ["https://example.com/tea_video1.mp4"],
  "audio_urls": ["https://example.com/tea_audio1.mp3"],
  "generate_audio": true,
  "size": "16:9",
  "duration": 11
}

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

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

{
  "model": "doubao-seedance-2.0",
  "prompt": "人物在城市街道自然行走,阳光明媚",
  "image_urls": ["asset://asset_a"],
  "duration": 5,
  "resolution": "720p"
}

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

{
  "model": "doubao-seedance-2.0",
  "prompt": "使用参考人像,人物优雅地走向镜头",
  "image_with_roles": [
    {
      "url": "asset://asset_a",
      "role": "reference_image"
    }
  ],
  "resolution": "720p",
  "duration": 5
}

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

{
  "model": "doubao-seedance-2.0-fast",
  "prompt": "人物在公园里漫步,微风轻拂",
  "image_urls": ["asset://asset_a"],
  "duration": 5,
  "resolution": "720p"
}

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

将审核通过的人像素材与参考视频结合,驱动人物完成指定动作。

{
  "model": "doubao-seedance-2.0",
  "prompt": "人物按照参考视频的节奏起舞,动作连贯自然",
  "image_urls": ["https://example.com/dance_reference.jpg", "asset://asset_a"],
  "video_urls": ["https://example.com/dance_reference.mp4", "asset://asset_a"],
  "duration": 8,
  "resolution": "720p"
}
注意

查询任务结果

视频生成为异步任务,提交后会返回 task_id。使用 获取任务状态 接口查询生成进度和结果。

与 1.5 Pro 版本的差异

特性 1.5 Pro 2.0 / 2.0 fast
分辨率 480p/720p/1080p 480p/720p/1080p/4k(fast 仅 480p/720p)
时长范围 4-12秒 5-15秒
默认时长 5秒 5秒
宽高比参数 aspect_ratio size(新增 adaptive 自适应)
音频生成 audio 参数 generate_audio 参数
参考视频 不支持 支持 video_urls
参考音频 不支持 支持 audio_urls
图生视频 image_urls / image_with_roles image_urls / image_with_roles
有声视频 不支持 支持 generate_audio
连续视频 不支持 支持 return_last_frame
快速版 不支持 支持 doubao-seedance-2.0-fast