Seedance 视频生成
通过AceDataCloud的Seedance(字节跳动)API生成AI舞蹈和运动视频。
设置: 请参阅 authentication 了解令牌设置。
快速开始
curl -X POST https://api.acedata.cloud/seedance/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"model": "doubao-seedance-2-0-260128", "content": [{"type": "text", "text": "a dancer performing contemporary ballet in a misty forest"}], "callback_url": "https://api.acedata.cloud/health"}'
异步: 请参阅 async task polling。通过
POST /seedance/tasks并携带{"id": "..."}进行轮询。 此接口会立即返回一个任务ID。轮询获取结果:
curl -X POST https://api.acedata.cloud/seedance/tasks \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"id": "<来自上述请求的task_id>"}'
模型
Seedance 2.0(当前代次——多模态参考)
2.0系列增加了多模态参考输入:真人/角色图像参考、参考音频和参考视频(参见下方的工作流)。
| 模型 | 最佳用途 | 最大分辨率 |
|---|---|---|
doubao-seedance-2-0-260128 | 最高质量、真人/角色参考、4k输出 | 4k |
doubao-seedance-2-0-fast-260128 | 更快的2.0生成 | 720p |
doubao-seedance-2-0-mini-260615 | 轻量级/最具成本效益的2.0 | 720p |
Seedance 1.x
| 模型 | 类型 | 最佳用途 |
|---|---|---|
doubao-seedance-1-5-pro-251215 | 文本+图像转视频 | 1.5旗舰版本,支持音频 |
doubao-seedance-1-0-pro-250528 | 文本+图像转视频 | 通用,质量可靠 |
doubao-seedance-1-0-pro-fast-251015 | 文本+图像转视频 | 更快的Pro生成 |
doubao-seedance-1-0-lite-t2v-250428 | 仅文本转视频 | 轻量级文本转视频 |
doubao-seedance-1-0-lite-i2v-250428 | 仅图像转视频 | 轻量级图像转视频 |
工作流
1. 文本转视频
在 content 数组中传递一个文本内容项。
POST /seedance/videos
{
"model": "doubao-seedance-1-0-pro-250528",
"content": [
{"type": "text", "text": "a street dancer doing breakdancing moves in an urban setting"}
],
"resolution": "1080p",
"ratio": "16:9",
"duration": 5
}
2. 图像转视频
在文本旁边包含一个图像内容项(可选的 role)。
POST /seedance/videos
{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{"type": "text", "text": "the person starts dancing gracefully"},
{
"type": "image_url",
"role": "first_frame",
"image_url": {"url": "https://example.com/dancer.jpg"}
}
],
"resolution": "720p",
"duration": 5
}
图像角色:
first_frame— 图像用作开场帧last_frame— 图像用作闭幕帧reference_image— 图像用作风格/主题/真人参考(Seedance 2.0保持参考人物或角色一致)
参考媒体(仅限Seedance 2.0):
audio_url— 用于音色/背景音乐的参考音频(无role)video_url— 用于主题、摄像机运动、动作或整体风格的参考视频(无role)
3. 首帧+尾帧
同时提供开始帧和结束帧图像:
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "smooth transition between two scenes"},
{"type": "image_url", "role": "first_frame", "image_url": {"url": "https://example.com/start.jpg"}},
{"type": "image_url", "role": "last_frame", "image_url": {"url": "https://example.com/end.jpg"}}
]
}
4. 真人/角色参考(Seedance 2.0)
Seedance 2.0模型(doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615)可以在全新场景中保持特定人物或角色一致。将一张或多张照片作为 image_url 项传递,并设置 role: "reference_image" —— 模型会保持该主题的外观。最多可接受9张参考图像。
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "the same person walking through a neon-lit night market, cinematic"},
{"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}}
],
"resolution": "1080p",
"duration": 8
}
5. 参考音频/视频(Seedance 2.0)
2.0模型还接受参考音频(音色、背景音乐)和参考视频(主题内容、摄像机运动、动作、整体风格)。添加 audio_url 和/或 video_url 内容项。限制:每个请求最多3个音频和3个视频参考。
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "a singer performing on stage, matching the reference voice and motion"},
{"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}},
{"type": "audio_url", "audio_url": {"url": "https://example.com/voice.mp3"}},
{"type": "video_url", "video_url": {"url": "https://example.com/motion.mp4"}}
],
"generate_audio": true
}
参数
| 参数 | 值 | 描述 |
|---|---|---|
model | 见模型表 | 要使用的模型(必填) |
content | 数组 | 输入项:text、image_url、audio_url(2.0版)、video_url(2.0版)(必填) |
resolution | "480p"、"720p"、"1080p"、"4k" | 输出分辨率。4k 仅适用于 doubao-seedance-2-0-260128(标准版);2-0-fast / 2-0-mini 最高仅支持 720p(默认值:pro/2.0 为720p,lite 为480p) |
ratio | "16:9"、"4:3"、"1:1"、"3:4"、"9:16"、"21:9"、"adaptive" | 宽高比(默认值:16:9) |
duration | 2 – 15 | 时长(秒)(Seedance 2.0支持4–15秒) |
frames | 29–361(必须满足 25+4n) | 帧数——与 duration 互斥 |
seed | -1 到 4294967295 | 用于可重复结果的种子(-1 = 随机) |
generate_audio | true / false | 生成音频(由 doubao-seedance-1-5-pro-251215 和 doubao-seedance-2-0 系列支持;其他模型忽略) |
camerafixed | true / false | 生成时固定摄像机位置 |
watermark | true / false | 为生成的视频添加水印 |
return_last_frame | true / false | 返回生成视频的最后一帧 |
service_tier | "default"、"flex" | 处理层(默认值:default) |
execution_expires_after | 数字 | 任务超时阈值(秒) |
内联参数语法
你也可以直接在文本提示中使用 --param value 语法嵌入生成参数:
A kitten yawning at the camera. --rs 720p --rt 16:9 --dur 5 --fps 24 --seed 42
支持的内联参数:--rs(分辨率)、--rt(宽高比)、--dur(时长)、--frames、--fps(仅24)、--seed、--cf(camera_fixed)、--wm(水印)。
注意事项
- 模型名称使用
doubao-*约定(例如doubao-seedance-1-0-pro-250528)——旧的短名称如seedance-1.0无效 content数组取代了旧的prompt+image_url字段;始终使用content- 每个内容项中图像和文本场景是互斥的——每个项要么有
text,要么有image_url,不能同时存在 first_frame和last_frame可以在一个请求中组合,但reference_image与first_frame/last_frame互斥——不要将参考图像与首帧/尾帧混合generate_audio: true由doubao-seedance-1-5-pro-251215和doubao-seedance-2-0系列支持;其他模型忽略此字段- Lite模型已拆分:
*-lite-t2v-*仅接受文本,*-lite-i2v-*仅接受图像转视频 audio_url和video_url参考项仅由 Seedance 2.0系列使用- 分辨率选项为
480p、720p、1080p和4k(4k仅适用于doubao-seedance-2-0-260128;2-0-fast/2-0-mini最高仅支持720p)——没有360p或540p service_tier的值为"default"和"flex"(不是 "standard" / "premium")- 时长范围为 2–15秒(Seedance 2.0支持4–15秒)——超出此范围的值将失败
- 任务状态使用
"succeeded"(不是 "completed")——轮询时检查此值
MCP:
pip install mcp-seedance| 托管:https://seedance.mcp.acedata.cloud/mcp| 请参阅 所有MCP服务器