doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615、doubao-seedance-2-5-260628。| 模型名称 | 说明 | 支持分辨率 |
|---|---|---|
| doubao-seedance-2-0-260128 | Seedance 2.0 标准版,画质更优,生成较慢(约 5-8 分钟) | 480p、720p、1080p、4k |
| doubao-seedance-2-0-fast-260128 | Seedance 2.0 快速版,速度更快(约 3-4 分钟),画质略低 | 480p、720p |
| doubao-seedance-2-0-mini-260615 | Seedance 2.0 精简版,成本更低、速度更快,适合大批量生成 | 480p、720p |
| doubao-seedance-2-5-260628 | Seedance 2.5,视频时长上限延长至 30 秒,素材上限提升至 50 个,原生多语言支持 | 480p、720p、1080p |
分辨率说明:仅 doubao-seedance-2-0-260128(标准版)支持 1080p 与 4k 高分辨率;doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615、doubao-seedance-2-5-260628仅支持 480p 与 720p。详见下方 resolution 参数说明。
接口统一说明:以上模型使用基本相同的请求参数( metadata.content[]+metadata.ratio+metadata.duration),大多数场景下只需切换model字段即可切换模型;但各模型在分辨率、时长上限、素材数量等方面存在差异,doubao-seedance-2-5-260628另有独立的智能控制行为,详见下方对应章节。
ratio 为 adaptive、duration 为 -1 智能控制输出视频的宽高比和时长;但在视频编辑、视频延长、首帧或首尾帧生视频任务中具有特殊的控制行为,详见下方Seedance 2.5 智能控制行为。POST {BASE_URL}/v1/video/generationsGET {BASE_URL}/v1/video/generations/{task_id}| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称:doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615 或 doubao-seedance-2-5-260628 |
| prompt | string | 是 | 文本提示词(平台校验要求非空,实际提示词通过 metadata.content 传递) |
| metadata | object | 是 | 扩展参数对象,包含所有 Seedance 2.0 / 2.5 参数 |
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
| content | object[] | 是 | 输入给模型的内容数组,详见下方 content 参数说明 | - |
| generate_audio | boolean | 否 | 控制生成的视频是否包含与画面同步的声音 | true |
| resolution | string | 否 | 视频分辨率,取值随模型而不同,详见下方 resolution 参数说明 | "720p" |
| ratio | string | 否 | 视频宽高比 | "adaptive" |
| duration | integer | 否 | 视频时长(秒) | 5 |
| tools | object[] | 否 | 配置模型要调用的工具 | - |
| output_format | string | 否 | 输出视频格式,mp4 或 mov,仅 doubao-seedance-2-5-260628 支持,详见下方 output_format 参数说明 | "mp4" |
| omni_reference_task_type | string | 否 | 全模态参考生视频任务类型引导,auto / reference / edit / extend,仅 doubao-seedance-2-5-260628 支持,详见下方 omni_reference_task_type 参数说明 | "auto" |
注意: prompt字段必须非空(平台校验要求),但实际发送给上游的提示词来自metadata.content中的文本内容。如果未传metadata.content,平台会自动将prompt转换为content数组。
metadata.content 为对象数组,输入给模型生成视频的信息,支持文本、图片、音频、视频。支持以下几种组合:| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | string | 是 | 固定为 "text" |
| text | string | 是 | 文本提示词,描述期望生成的视频。支持中英文。建议中文不超过 500 字,英文不超过 1000 词。字数过多信息容易分散,模型可能忽略细节,造成视频缺失部分元素。 |
{
"type": "text",
"text": "清晨的海边,金色阳光照耀在海面上,一只海豚跃出水面,水花四溅"
}| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | string | 是 | 固定为 "image_url" |
| image_url | object | 是 | 图片对象 |
| image_url.url | string | 是 | 图片 URL、Base64 编码或素材 ID(见下方说明) |
| role | string | 条件必填 | 图片的位置或用途(见下方说明) |