Seedance / Video Generation
Seedance 视频生成
Seedance 是字节跳动 Doubao 视频生成模型系列,适合文生视频、图片参考、视频参考和带声音的短视频创作。请使用任务式接口提交请求,再轮询任务结果。
可用模型
调用时在 model 字段填写控制台开放的模型名。当前 Seedance 系列重点开放以下模型:
| 模型 | 说明 | 常见能力 |
|---|---|---|
doubao-seedance-1-5-pro-251215 | Seedance 1.5 Pro,高质量视频生成模型。 | 文生视频、图片参考、声音开关、draft 样片模式。 |
doubao-seedance-2-0-fast-260128 | Seedance 2.0 Fast,侧重更快产出和成本效率。 | 文生视频、图片参考、参考视频,常用 480p / 720p。 |
doubao-seedance-2-0-260128 | Seedance 2.0,高质量视频生成模型。 | 文生视频、图片参考、参考视频,支持更高分辨率档位。 |
具体可调用能力以模型广场、控制台模型权限和接口返回为准。未开放或未配置价格的能力不会被调用。
接口和能力
| 能力 | 接口 | 用途 | 关键参数 |
|---|---|---|---|
| 文生视频 | POST /v1/video/generations | 只通过文字提示词生成视频。 | model、prompt、duration、resolution |
| 图片参考 | POST /v1/video/generations | 通过图片约束人物、主体或画面风格。 | image 或 images、prompt、duration、resolution |
| 参考视频 | POST /v1/video/generations | 使用视频作为运动、镜头或风格参考。 | content[].type = "video_url"、content[].video_url.url、content[].role |
| 有声视频 | POST /v1/video/generations | 请求模型生成带声音的视频。 | metadata.generate_audio |
| draft 样片 | POST /v1/video/generations | Seedance 1.5 Pro 的低成本预览样片模式。 | metadata.draft |
图片、视频 URL 必须能被服务端公网访问,不能使用本机地址、内网地址、需要登录的地址或已过期签名地址。参考视频请求中如果没有显式传 role,平台会按 reference_video 处理。
常用参数
| 参数 | 可用值 | 说明 |
|---|---|---|
prompt | 文本 | 视频内容、主体动作、镜头、风格和限制条件。该字段必填。 |
duration | 模型支持的秒数 | 目标视频时长。实际支持值由模型和上游能力决定。 |
resolution | 480p、720p、1080p、4k | 控制输出清晰度和计费项。不同模型支持范围不同。 |
ratio | 如 16:9、9:16、1:1 | 输出画幅比例。请按模型支持值填写。 |
image / images | 公网图片 URL | 图片参考输入。单图可用 image,多图可用 images。 |
content | 内容数组 | 高级输入。可传图片、视频或其他模型支持的内容项。图片、视频 URL 必须能被服务端公网访问。 |
content[].role | first_frame、last_frame、reference_image、reference_video、reference_audio | 声明参考素材的用途。首帧/尾帧图片分别用 first_frame、last_frame;普通参考图片用 reference_image;参考视频用 reference_video;参考音频用 reference_audio。如果 video_url 内容项不传 role,平台默认按 reference_video 处理。具体组合是否可用以所选模型支持为准。 |
metadata.generate_audio | true / false | 是否生成声音。主要用于支持声音的 Seedance 1.5 Pro 请求。 |
metadata.draft | true / false | 开启 Seedance 1.5 Pro draft 样片模式。draft 通常用于预览,输出消耗会随模型返回的 token 数变化。 |
metadata.seed | 整数 | 用于提高结果可复现性。是否生效取决于模型。 |
如果请求的模型不支持某个组合,例如参考视频、4K、声音或 draft,接口会返回 400 类错误。排障时先用文生视频、较低分辨率和无声音参数跑通,再逐步增加输入和档位。
计费说明
Seedance 使用模型实际返回的 token 用量结算,不按视频秒数直接结算。模型广场会展示不同模型、分辨率、参考视频、有声和 draft 等计费项,最终价格以控制台和模型广场展示为准。
| 场景 | 计费展示 | 说明 |
|---|---|---|
| Seedance 1.5 Pro 普通模式 | 按模型 token 单价和实际 token 用量 | 是否生成声音会影响模型行为和用量,价格以模型广场展示为准。 |
| Seedance 1.5 Pro draft 模式 | 按模型 token 单价和实际 token 用量 | draft 便宜通常来自返回 token 数更少,不代表每 token 单价一定不同。 |
| Seedance 2.0 / 2.0 Fast | 区分是否带参考视频和分辨率 | 常见展示项类似 no_video.720p、with_video.720p。 |
文生视频示例
curl "https://youlai.ai/v1/video/generations" \
-H "Authorization: Bearer sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-2-0-fast-260128",
"prompt": "清晨城市天台,一位创作者打开笔记本电脑,镜头缓慢推进,真实电影感",
"duration": 5,
"resolution": "720p",
"metadata": {
"ratio": "16:9"
}
}'
图片参考示例
curl "https://youlai.ai/v1/video/generations" \
-H "Authorization: Bearer sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-2-0-260128",
"prompt": "保持人物身份和服装一致,让人物自然转身并看向镜头",
"image": "https://example.com/person.jpg",
"duration": 5,
"resolution": "1080p"
}'
参考视频示例
参考视频使用 content 数组传入。建议显式设置 role: "reference_video";如果省略 role,平台也会把 video_url 内容项按参考视频处理。
curl "https://youlai.ai/v1/video/generations" \
-H "Authorization: Bearer sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-2-0-260128",
"prompt": "参考视频的镜头运动和节奏,生成一段产品展示视频",
"duration": 5,
"resolution": "720p",
"content": [
{
"type": "video_url",
"role": "reference_video",
"video_url": {
"url": "https://example.com/reference.mp4"
}
}
]
}'
有声视频示例
支持声音的模型可以通过 metadata.generate_audio 请求生成有声视频。
curl "https://youlai.ai/v1/video/generations" \
-H "Authorization: Bearer sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-1-5-pro-251215",
"prompt": "咖啡馆新品介绍短片,人物自然讲解,环境音柔和",
"duration": 5,
"resolution": "720p",
"metadata": {
"generate_audio": true
}
}'
如果不需要声音,请省略 generate_audio 或设为 false。
draft 样片示例
Seedance 1.5 Pro 支持 draft 样片模式,适合先做低成本预览。draft 通常只用于预览,不建议作为最终成片参数。
curl "https://youlai.ai/v1/video/generations" \
-H "Authorization: Bearer sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-1-5-pro-251215",
"prompt": "年轻人在书桌前整理产品草图,镜头从侧面平滑移动",
"duration": 5,
"resolution": "480p",
"metadata": {
"draft": true,
"generate_audio": false
}
}'
查询任务结果
提交成功后会返回平台任务 ID。使用同一任务查询接口加上任务 ID 轮询结果,直到任务进入成功或失败状态。
curl "https://youlai.ai/v1/video/generations/TASK_ID" \
-H "Authorization: Bearer sk-xxxxxxxx"
| 字段 | 说明 |
|---|---|
data.task_id | 平台任务 ID。 |
data.status | 任务状态,常见为排队、处理中、成功或失败。 |
data.progress | 任务进度。 |
data.result_url | 任务成功后的结果视频 URL。 |
data.fail_reason | 任务失败原因,例如素材不可访问、模型不支持该参数组合或安全审核失败。 |
也可以使用 GET /v1/videos/{task_id} 获取 OpenAI Video 风格的查询响应。
排障建议
| 问题 | 处理方式 |
|---|---|
| 400 参数错误 | 确认模型名、resolution、duration、metadata 是否属于当前模型支持范围。 |
| 素材不可访问 | 确认图片或视频 URL 在公网可访问,且没有登录、签名过期、防盗链或证书问题。 |
| 参考视频没有生效 | 使用 content[].type = "video_url",并确认 video_url.url 是可下载的视频文件。 |
| 声音或 draft 失败 | 先确认当前模型支持该参数。对 Seedance 1.5 Pro,draft 建议使用 480p。 |
| 费用高于预期 | 检查是否使用更高分辨率、参考视频、有声或更高 token 用量的提示词和素材组合。 |