Seedance 影片生成
透過 AceDataCloud 的 Seedance(字節跳動)API 生成 AI 舞蹈與動作影片。
設定: 請參閱認證以設定 Token。
快速開始
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": "在迷霧森林中表演當代芭蕾的舞者"}], "callback_url": "https://api.acedata.cloud/health"}'
非同步處理: 請參閱非同步任務輪詢。通過
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": "一位街舞舞者在城市環境中表演地板動作"}
],
"resolution": "1080p",
"ratio": "16:9",
"duration": 5
}
2. 圖片轉影片
在文字旁包含一個圖片內容項目(可選 role)。
POST /seedance/videos
{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{"type": "text", "text": "這個人開始優雅地跳舞"},
{
"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": "兩個場景之間的流暢過渡"},
{"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": "同一個人在霓虹燈夜市中行走,電影感"},
{"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": "在舞台上表演的歌手,匹配參考聲音和動作"},
{"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 | 數字 | 任務超時閾值(秒) |
內聯參數語法
你也可以直接在文字提示中使用 --參數 值 語法來嵌入生成參數:
正在打哈欠的小貓對著鏡頭。--rs 720p --rt 16:9 --dur 5 --fps 24 --seed 42
支援的內聯參數:--rs(解析度)、--rt(比例)、--dur(持續時間)、--frames(影格數)、--fps(僅 24)、--seed(種子)、--cf(相機固定)、--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 伺服器