Skip to main content
POST
相对 2.0 的主要变化:时长上限 15s → 30s;参考素材 9 图 + 3 视频 + 3 音频 → 30 图 + 10 视频 + 10 音频;支持纯音频参考;新增 mov 输出。
注意:分辨率仅 480p / 720p(2.0 的 1080p / 4k 在 2.5 不可用)。

认证

string
必填
Bearer Token 认证。访问 API Key 管理页面 获取密钥。

请求参数

string
必填
固定值:doubao-seedance-2.5
string
必填
提示词。可用 @图片1 / @视频1 / @音频1 指代参考素材(下标从 1 起,对应数组顺序)。示例:"全程使用@视频1的第一视角构图,@音频1作为背景音乐,首帧为@图片1"
string
默认值:"720p"
分辨率,仅支持
  • 480p
  • 720p(默认)
传入 1080p / 2k / 4k 等会同步 400
string
默认值:"adaptive"
宽高比(也接受字段名 aspect_ratio)。可选值:16:94:31:13:49:1621:9adaptive(默认)
视频编辑、视频延长、首帧/首尾帧任务对 size 有硬性限制,见 任务类型与限制
integer
默认值:"5"
时长(秒):
  • 4 ~ 30
  • -1:模型自动选择时长(提交时按 30 秒上限预扣,完成后按实际产出多退少补)
未传时按 5 秒生成与计费。
boolean
默认值:"true"
是否生成音频(也接受字段名 audio)。
  • true:有声视频(默认)
  • false:无声视频
boolean
默认值:"false"
是否添加「AI 生成」水印。默认 false
integer
随机种子。相同请求下不同 seed 通常得到不同结果;相同 seed 结果相近但不保证完全一致。
string
默认值:"mp4"
输出封装格式:
  • mp4(默认)
  • mov:更高色彩精度,推荐用于编辑 / 延长场景
array<string>
参考图 URL 数组,一律作为 reference_image支持:
  • 普通 URL:https://example.com/pic.jpg
  • 私域素材:asset://cm9xxxxxxxx
首帧 / 尾帧请用 image_with_roles
  • 最多 30
  • image_with_roles 不要混用冲突角色语义;首尾帧请走 image_with_roles
array<object>
带角色的图片数组。示例:
若同时存在 video_urls / audio_urlsfirst_frame / last_frame 会自动转为 reference_image(多模态参考任务)。
array<string>
参考视频 URL 数组(reference_video)。支持普通 URL 与 asset://...最多 10 个;总时长 ≤ 30s(单段 2~30s)。
array<string>
参考音频 URL 数组(reference_audio)。支持普通 URL 与 asset://...最多 10 段;总时长 ≤ 30s(单段 2~30s)。
2.5 支持纯音频参考(可不配图/视频)。
boolean
默认值:"false"
true 时,任务成功后额外返回尾帧图片,便于连续生成。
array<object>
工具列表,用于联网搜索等增强能力。示例:

素材要求

任务类型与限制

系统会按参考素材与提示词意图判定任务类型。后三种对 size / duration 有硬性限制,违反会在任务开始后异步失败(如 InvalidParameter.TaskTypeConstraint):

私域素材库(asset://

Seedance 2.0 私域虚拟人像 相同:在 image_urls / image_with_roles / video_urls / audio_urls 中可直接使用已审核通过的素材 ID:
已提交素材对 2.0 / 2.5 通用

计费

  • 秒 × 分辨率档 计费。
  • 有参考视频输入时:计费秒数 = 输入视频总时长(≤30s)+ 输出时长,走带输入参考的优惠档单价。
  • duration = -1(自动时长):提交时按上限 30 秒预扣,完成后按实际产出多退少补。
  • 未传 duration:按 5 秒生成与计费。
  • 任务失败或内容审核拦截:全额退款(仅成功出片收费)。

请求示例

文生视频(30 秒)

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

视频编辑

首尾帧生视频

私域素材

联网搜索

常见错误

响应

integer
响应状态码,成功时为 200
array
提交时返回 status / task_id
使用 获取任务状态 轮询。成功后取 result.videos[0].url(已转存,长期有效)。return_last_frame=true 时结果中附尾帧图片。

与 2.0 的差异