视频系列Seedance 2.0 / 2.5
接口概览与格式选择
Seedance 2.0 / 2.5 支持官方 content 格式和 ModelSell 通用视频格式，自动识别并上传 HTTPS 链接素材。
Seedance 2.0 / 2.5 通过异步任务生成视频：先创建任务，再按任务 ID 轮询状态，成功后按渠道响应读取 content.video_url、outputs[0] 或通用 video_url。2.5 的任务类型配置与完整返回字段见请求与返回参数。
素材支持自动上传。 在官方格式或通用视频格式的图片、视频、音频素材字段中，直接传入公网可访问的 https:// 链接，系统会自动识别并上传素材，无需提前调用 /api/assets/upload。
| 项目 | 说明 |
|---|---|
| 官方格式创建任务 | POST /api/v3/contents/generations/tasks |
| 官方格式查询任务 | GET /api/v3/contents/generations/tasks/{task_id} |
| 通用视频创建任务 | POST /v1/video/generations 或 POST /v1/videos |
| 通用视频查询任务 | GET /v1/video/generations/{task_id} 或 GET /v1/videos/{task_id} |
| 素材上传 | POST /api/assets/upload |
| 素材详情 | GET /api/assets/{id} |
| 支持模型 | doubao-seedance-2-5-260628、doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128 |
两种请求格式
官方格式适合需要精确控制 content[] 中图片、视频、音频素材角色的场景：
{
"model": "doubao-seedance-2-0-260128",
"content": [
{
"type": "text",
"text": "一只金色柴犬在樱花树下奔跑，镜头缓缓上升"
}
],
"resolution": "480p",
"ratio": "16:9",
"duration": 5,
"generate_audio": true,
"watermark": false
}通用视频格式适合已经接入 /v1/video/generations 或 /v1/videos 的业务，使用 prompt、image、metadata.video_url、metadata.audio_url 表达同样的输入：
{
"model": "doubao-seedance-2-0-fast-260128",
"prompt": "让画面中的人物缓缓转身微笑",
"image": "https://example.com/photo.jpg",
"duration": 5,
"size": "720p",
"metadata": {
"ratio": "16:9",
"generate_audio": true,
"watermark": false
}
}参数速查
| 字段 | 说明 |
|---|---|
resolution / size | 2.5：480p、720p、1080p；2.0 标准版还支持 4k，fast/mini 仅 480p、720p |
ratio | 默认 adaptive；还可用 16:9、9:16、3:4、1:1、4:3、21:9；2.5 编辑、延长、首帧/首尾帧必须为 adaptive |
duration | 2.5 默认 -1，可选 -1 或 4–30 秒；2.0 可选 -1 或 4–15 秒；2.5 编辑必须为 -1 |
omni_reference_task_type | 仅 2.5：auto（默认）、reference、edit、extend |
generate_audio | 是否生成与画面同步的声音，默认 true |
watermark | 是否添加水印，默认 false |
图片可以使用公网 URL；官网支持 Base64 Data URL，单张图片小于 30 MB、请求体不超过 64 MB，渠道可能采用更小限制。视频素材必须使用公网可访问 URL，不支持 Base64。
需要通过素材 ID 复用图片、视频或音频时，也可以手动调用 /api/assets/upload 上传 URL 素材，等素材状态为 Active 后，在官方格式或通用视频格式中使用 asset://<asset_id> 引用。详见素材上传与管理。