seedance-v2

Seedance 2.0 Pro — RunComfy 專業版套件

runcomfy.com · Seedance 2.0 Pro · GitHub

ByteDance Seedance 2.0 Pro — 多模態電影級影片生成器，內建原生唇形同步音訊 — 託管於 RunComfy Model API。

npx skills add agentspace-so/runcomfy-skills --skill seedance-v2 -g

何時選擇此模型（相較於同系列其他模型）

Seedance 2.0 Pro 的獨特優勢在於多模態電影級短影片：將角色圖片、場景影片和參考音訊結合成一個連貫的鏡頭。當參考角色/場景的忠實度很重要，且需要原生唇形同步時，請選擇它。

您想要	使用
唇形同步的代言人/對話廣告	Seedance 2.0 Pro
多模態參考（圖片 + 影片 + 音訊）	Seedance 2.0 Pro
品牌一致的多語言敘事	Seedance 2.0 Pro
目前盲測第一的影片品質	HappyHorse 1.0
從自訂音軌驅動唇形同步	Wan 2.7 (audio_url)
對現有素材進行動作編輯	Kling Video O1
超快速迭代	LTX 2

如果使用者明確提到「Seedance」/「Seedance 2」/「ByteDance video」，無論如何都導向此處。

先決條件

1. RunComfy CLI — npm i -g @runcomfy/cli
2. RunComfy 帳號 — runcomfy login 會開啟瀏覽器裝置碼流程。
3. CI / 容器 — 設定 RUNCOMFY_TOKEN=<token> 取代 runcomfy login。

端點 + 輸入架構

bytedance/seedance-v2/pro

欄位	型別	必填	預設值	備註
prompt	string	是	—	中文 ≤ 500 字元 或 英文 ≤ 1000 字。
image_url	array	否	[]	0–9 個參考（JPEG/PNG/WebP/BMP/TIFF/GIF）。
video_url	array	否	[]	0–3 個片段（MP4/MOV），每個 2–15 秒。
audio_url	array	否	[]	0–3 個音訊參考（WAV/MP3），2–15 秒，每個 < 15MB。
aspect_ratio	enum	否	adaptive	adaptive, 16:9, 9:16, 4:3, 3:4, 1:1, 21:9。
duration	int	否	5	4–15（整數秒）。
resolution	enum	否	720p	480p 或 720p。
generate_audio	bool	否	true	內建同步語音/音效/音樂。
seed	int	否	—	可重現性。

如何呼叫

預設（純文字，5 秒，720p 含音訊）：

runcomfy run bytedance/seedance-v2/pro \
  --input '{"prompt": "<使用者提示>"}' \
  --output-dir <絕對路徑>

含角色參考的唇形同步廣告（圖片穩定，文字演進）：

runcomfy run bytedance/seedance-v2/pro \
  --input '{
    "prompt": "Medium close-up. The woman explains today'\''s special in a warm friendly tone, slow push-in, soft window light, gentle cafe ambience.",
    "image_url": ["https://.../barista-headshot.jpg"],
    "duration": 8,
    "aspect_ratio": "9:16"
  }' \
  --output-dir <絕對路徑>

多模態（圖片 + 影片 + 音訊參考）：

runcomfy run bytedance/seedance-v2/pro \
  --input '{
    "prompt": "Subject from image 1 walks through the café from video 1, voice tone matches audio 1.",
    "image_url": ["https://.../subject.jpg"],
    "video_url": ["https://.../cafe-locked-shot.mp4"],
    "audio_url": ["https://.../voice-ref.mp3"]
  }' \
  --output-dir <絕對路徑>

CLI 會提交、輪詢、取得結果，並將 *.runcomfy.net/*.runcomfy.com 的 URL 下載到 --output-dir。

提示技巧 — 實際有效的方法

圖片與文字的分工。 這是最重要的一條規則。穩定的身份（臉部、服裝、品牌標誌、Logo）→ 放入 image_url。演進的敘事（動作、情緒、燈光、運鏡）→ 放入 prompt。試圖用文字詳細描述臉部會浪費 token 並導致偏移。

用白話描述運鏡與動作。 「Medium close-up」、「slow push-in」、「handheld follow」、「locked-off wide」等指令都有效。組合使用："Medium close-up. Slow push-in over 3 seconds. Handheld, slight breathing motion."

使用 generate_audio: true 時的音訊方向 — 指定語氣："warm friendly conversational"、"calm instructional"、"crisp newsroom delivery"。環境音："gentle cafe chatter, distant traffic, no foreground music"。

參考媒體規格 — 影片必須 2–15 秒；音訊必須 ≤15MB 且 2–15 秒。超出範圍的檔案會被拒絕。參考素材的長寬比應與輸出相符，以避免裁切。

反模式：

• 混合風格差異極大的參考素材（水彩 + 寫實）→ 造成混淆。
• 提示中出現衝突的風格線索 → 簡化提示，移除矛盾。
• 試圖用文字描述穩定的身份 → 改用 image_url。
• 要求超過 15 秒的片段 → 回傳 422；請分段呼叫。

擅長領域

使用案例	為何選擇 Seedance 2.0 Pro
代言人/對話廣告	內建原生唇形同步，無需額外 TTS 步驟
品牌一致的多語言敘事	圖片參考維持身份；文字驅動翻譯
電影級短影片預覽	運鏡語法 + 多模態參考
含參考音樂/配音語氣的廣告創意	音訊參考引導語音/情緒，不鎖定唇形同步
可重現的變體測試	種子控制 + 固定架構

範例提示（經驗證可產生優異結果）

預設遊樂場範例：

Golden hour on a quiet cafe terrace: a barista wipes the counter, then
looks up and explains today's special in a friendly tone, natural
lip-sync. Medium close-up, slow push-in; warm side light, soft bokeh
through glass, gentle cafe ambience and subtle film grain.

多模態唇形同步（文字 + 圖片）：

Same person as image 1 in a softly-lit recording booth, leaning into
the mic, says: "We just shipped the biggest update of the year."
Calm conversational tone. Medium close-up, locked tripod, shallow DOF,
warm key light from camera-left.

限制

• 長度 4–15 秒 — 此端點不支援更長的片段。
• 解析度上限 720p（遊樂場變體）。
• 參考媒體規格 — 影片/音訊必須 2–15 秒；音訊 < 15MB。
• 唇形同步品質 — 取決於提示清晰度；無法保證在所有條件下完美。
• 無 @ 語法進行角色綁定 — 依賴圖片參考與提示對齊。

退出碼

碼	意義
0	成功
64	CLI 參數錯誤
65	輸入 JSON 錯誤/架構不符
69	上游 5xx 錯誤
75	可重試：逾時 / 429
77	未登入或 token 被拒絕

完整參考：docs.runcomfy.com/cli/troubleshooting。

運作方式

此技能會以符合架構的 JSON 主體呼叫 runcomfy run bytedance/seedance-v2/pro。CLI 會 POST 到 https://model-api.runcomfy.net/v1/models/bytedance/seedance-v2/pro，輪詢請求、取得結果，並將任何 .runcomfy.net/.runcomfy.com URL 下載到 --output-dir。Ctrl-C 會在退出前取消遠端請求。

安全性與隱私

• Token 儲存：runcomfy login 將 API token 寫入 ~/.config/runcomfy/token.json，權限設為 0600（僅擁有者可讀寫）。在 CI/容器中設定 RUNCOMFY_TOKEN 環境變數可繞過檔案。
• 輸入邊界：使用者提示透過 --input 以 JSON 字串傳遞給 CLI。CLI 不會對提示進行 shell 展開；它直接將 JSON 主體透過 HTTPS 傳送給 Model API。提示內容無 shell 注入風險。
• 第三方內容：您傳遞的圖片/遮罩/影片 URL 由 RunComfy 模型伺服器擷取，而非您本機的 CLI。請將外部 URL 視為不受信任；基於圖片的提示注入是任何圖片/影片編輯模型的已知風險。
• 對外端點：僅 model-api.runcomfy.net（請求提交）和 *.runcomfy.net / *.runcomfy.com（生成輸出的下載白名單）。無遙測、無回呼。
• 生成檔案大小上限：CLI 會中止任何超過 2 GiB 的單一下載，以防止惡意或失控的模型輸出導致磁碟填滿。