seedance-v2
prime-skills/runcomfy-agent-skills
Generate cinematic short-form video with ByteDance Seedance 2.0 Pro on RunComfy, with native lip-sync and multi-modal references.
What is seedance-v2?
Seedance 2.0 Pro is a multimodal video generator hosted on RunComfy that creates 4–15 second cinematic videos from text prompts, character images, scene videos, and audio references with synchronized lip-sync. Use it when you need identity-consistent video with native audio synchronization, such as spokesperson ads, branded narratives, or previs with reference media.
- Combine up to 9 images, 3 videos, and 3 audio tracks in a single coherent video generation
- Generate native in-pass lip-synced speech and audio without separate TTS steps
- Support multiple aspect ratios (16:9, 9:16, 4:3, 3:4, 1:1, 21:9, adaptive) and resolutions (480p, 720p)
- Control video duration from 4–15 seconds with reproducible results via seed parameter
- Route to alternative models (HappyHorse 1.0, Wan 2.7, Kling) based on use case requirements
How to install seedance-v2
npx skills add https://github.com/prime-skills/runcomfy-agent-skills --skill seedance-v2- RunComfy CLI: npm i -g @runcomfy/cli
- RunComfy account via runcomfy login (or RUNCOMFY_TOKEN environment variable for CI/containers)
How to use seedance-v2
- 1.Install the skill: npx skills add agentspace-so/runcomfy-skills --skill seedance-v2 -g
- 2.Prepare reference media: character images (JPEG/PNG/WebP/BMP/TIFF/GIF), video clips (MP4/MOV, 2–15s), and/or audio files (WAV/MP3, 2–15s, <15MB each)
- 3.Craft your prompt: put stable identity (face, costume, logo) in image_url; put evolving narrative (action, mood, lighting, camera movement) in the text prompt
- 4.Run the generation: runcomfy run bytedance/seedance-v2/pro --input '{...}' --output-dir <path>
- 5.Retrieve the output video from the specified directory once the CLI completes
Use cases
- Create lip-synced spokesperson or dialogue ads with stable character identity from reference images
- Generate brand-consistent multi-language narratives by anchoring identity in images and evolving narrative in text
- Produce cinematic short-form film previs combining camera-shot grammar with multi-modal references
- Build ad creatives that match reference music or voice tone without locking final lip-sync
- Test reproducible video variants using seed control and fixed schema
- Video producers and editors working on short-form content
- Ad agencies creating spokesperson or branded narrative campaigns
- Filmmakers doing previs or storyboard animation
- Content creators needing consistent character identity across multiple videos
- Teams requiring reproducible, multi-language video generation
seedance-v2 FAQ
Use Seedance 2.0 Pro for multi-modal cinematic short-form with native lip-sync (spokesperson ads, branded narratives). Use HappyHorse 1.0 for top blind-vote video quality, Wan 2.7 for audio-driven lip-sync from your own track, and Kling for motion editing on existing footage.
Keep your prompt clear and concise; describe tone (warm, calm, crisp) and camera movement (push-in, locked tripod) in plain language. Put stable identity in image_url and evolving narrative in the prompt. Lip-sync quality depends on prompt clarity and is not guaranteed perfect under all conditions.
Up to 9 images, 3 videos (2–15s each), and 3 audio files (2–15s, <15MB each). Videos and audio outside the 2–15s range will be rejected. Match the aspect ratio of your references to your output to avoid crops.
No, the duration field accepts 4–15 seconds only. For longer content, segment into multiple calls and stitch the results.
Set the RUNCOMFY_TOKEN environment variable instead of running runcomfy login. The CLI will use the token from the environment.
Full instructions (SKILL.md)
Source of truth, from prime-skills/runcomfy-agent-skills.
name: seedance-v2
displayName: "Seedance 2.0 Pro — Pro Pack on RunComfy"
description: >
Generate cinematic short-form video with ByteDance Seedance 2.0 Pro
on RunComfy. Documents Seedance 2.0 Pro's strengths (multi-modal references
— up to 9 images, 3 videos, 3 audio — synchronized in-pass audio with
natural lip-sync, cinematic motion refinement), the 4–15s duration
schema, and when to route to HappyHorse 1.0 / Wan 2.7 / Kling instead.
Calls runcomfy run bytedance/seedance-v2/pro through the local
RunComfy CLI. Triggers on "seedance", "seedance 2", "seedance v2",
"seedance pro", "bytedance video", or any explicit ask to generate
video with this model.
homepage: https://www.runcomfy.com
license: MIT
Seedance 2.0 Pro — Pro Pack on RunComfy
runcomfy.com · Seedance 2.0 Pro · GitHub
ByteDance Seedance 2.0 Pro — multimodal cinematic video generator with native lip-synced audio — hosted on the RunComfy Model API.
npx skills add agentspace-so/runcomfy-skills --skill seedance-v2 -g
When to pick this model (vs siblings)
Seedance 2.0 Pro's distinct strength is multi-modal cinematic short-form: combine character images + scene videos + reference audio into one coherent shot. Pick it when fidelity to a reference identity / scene matters and you want native lip-sync.
| You want | Use |
|---|---|
| Lip-synced spokesperson / dialogue ad | Seedance 2.0 Pro |
| Multi-modal references (image + video + audio) | Seedance 2.0 Pro |
| Brand-consistent multi-language narrative | Seedance 2.0 Pro |
| Currently-#1 blind-vote video quality | HappyHorse 1.0 |
| Audio-driven lip-sync from your own track | Wan 2.7 (audio_url) |
| Motion editing on existing footage | Kling Video O1 |
| Ultra-fast iteration | LTX 2 |
If the user said "Seedance" / "Seedance 2" / "ByteDance video" explicitly, route here regardless.
Prerequisites
- RunComfy CLI —
npm i -g @runcomfy/cli - RunComfy account —
runcomfy loginopens a browser device-code flow. - CI / containers — set
RUNCOMFY_TOKEN=<token>instead ofruncomfy login.
Endpoints + input schema
bytedance/seedance-v2/pro
| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
prompt | string | yes | — | CN ≤ 500 chars OR EN ≤ 1000 words. |
image_url | array | no | [] | 0–9 references (JPEG/PNG/WebP/BMP/TIFF/GIF). |
video_url | array | no | [] | 0–3 clips (MP4/MOV), 2–15s each. |
audio_url | array | no | [] | 0–3 audio refs (WAV/MP3), 2–15s, < 15MB each. |
aspect_ratio | enum | no | adaptive | adaptive, 16:9, 9:16, 4:3, 3:4, 1:1, 21:9. |
duration | int | no | 5 | 4–15 (whole seconds). |
resolution | enum | no | 720p | 480p or 720p. |
generate_audio | bool | no | true | In-pass synchronized speech / SFX / music. |
seed | int | no | — | Reproducibility. |
How to invoke
Default (text only, 5s, 720p with audio):
runcomfy run bytedance/seedance-v2/pro \
--input '{"prompt": "<user prompt>"}' \
--output-dir <absolute/path>
Lip-synced ad with character reference (image-stable, text-evolves):
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 <absolute/path>
Multi-modal (image + video + audio refs):
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 <absolute/path>
The CLI submits, polls, fetches the result, downloads *.runcomfy.net/*.runcomfy.com URLs into --output-dir.
Prompting — what actually works
Image vs text division. This is the single most important rule. Stable identity (face, costume, brand mark, logo) → put in image_url. Evolving narrative (action, mood, lighting, camera) → put in prompt. Trying to verbally describe a face in detail wastes tokens and produces drift.
Camera + motion in plain language. "Medium close-up", "slow push-in", "handheld follow", "locked-off wide" all work as directives. Combine: "Medium close-up. Slow push-in over 3 seconds. Handheld, slight breathing motion."
Audio direction with generate_audio: true — say the tone: "warm friendly conversational", "calm instructional", "crisp newsroom delivery". For ambient: "gentle cafe chatter, distant traffic, no foreground music".
Reference media specs — videos must be 2–15s; audio must be ≤15MB and 2–15s. Out-of-range files reject. Match aspect ratio of refs to your output to avoid crops.
Anti-patterns:
- Mixing radically different aesthetic refs (watercolor + photoreal) → confuses.
- Conflicting style cues in prompt → simplify by removing contradictions.
- Trying to describe stable identity verbally → use
image_urlinstead. - Asking for >15s clips → 422; segment into multiple calls.
Where it shines
| Use case | Why Seedance 2.0 Pro |
|---|---|
| Spokesperson / dialogue ads | Native in-pass lip-sync, no separate TTS step |
| Brand-consistent multi-language narratives | Image refs hold identity; text drives translation |
| Cinematic short-form film previs | Camera-shot grammar + multi-modal refs |
| Ad creatives with reference music / VO tone | Audio refs guide voice / mood without locking lip-sync |
| Reproducible variant testing | Seed control + fixed schema |
Sample prompts (verified to produce strong results)
Default playground example:
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.
Multi-modal lip-sync (text + image):
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.
Limitations
- Duration 4–15s — no longer clips on this endpoint.
- Resolution ceiling 720p on the playground variant.
- Reference media specs — videos / audio must be 2–15s; audio < 15MB.
- Lip-sync quality — depends on prompt clarity; not guaranteed perfect under all conditions.
- No
@-syntax for character binding — relies on image refs + prompt alignment.
Exit codes
| code | meaning |
|---|---|
| 0 | success |
| 64 | bad CLI args |
| 65 | bad input JSON / schema mismatch |
| 69 | upstream 5xx |
| 75 | retryable: timeout / 429 |
| 77 | not signed in or token rejected |
Full reference: docs.runcomfy.com/cli/troubleshooting.
How it works
The skill invokes runcomfy run bytedance/seedance-v2/pro with a JSON body matching the schema. The CLI POSTs to https://model-api.runcomfy.net/v1/models/bytedance/seedance-v2/pro, polls the request, fetches the result, and downloads any .runcomfy.net/.runcomfy.com URL into --output-dir. Ctrl-C cancels the remote request before exit.
Security & Privacy
- Token storage:
runcomfy loginwrites the API token to~/.config/runcomfy/token.jsonwith mode 0600 (owner-only read/write). SetRUNCOMFY_TOKENenv var to bypass the file entirely in CI / containers. - Input boundary: the user prompt is passed as a JSON string to the CLI via
--input. The CLI does NOT shell-expand the prompt; it transmits the JSON body directly to the Model API over HTTPS. No shell injection surface from prompt content. - Third-party content: image / mask / video URLs you pass are fetched by the RunComfy model server, not by the CLI on your machine. Treat external URLs as untrusted; image-based prompt injection is a known risk for any image-edit / video-edit model.
- Outbound endpoints: only
model-api.runcomfy.net(request submission) and*.runcomfy.net/*.runcomfy.com(download whitelist for generated outputs). No telemetry, no callbacks. - Generated-file size cap: the CLI aborts any single download > 2 GiB to prevent disk-fill from a malicious or runaway model output.
Related skills
More from prime-skills/runcomfy-agent-skills and the wider catalog.

video-extend
Extend video clips shot-by-shot using Google Veo 3-1 via RunComfy CLI.

video-inpainting
Remove objects, watermarks, and unwanted regions across video frames via prompt-driven edits on RunComfy.

video-outpainting
Extend video canvas and change aspect ratio via Wan 2-7 or ComfyUI workflows on RunComfy.

wan-2-7
Generate text-to-video with Wan 2.7's audio-driven lip-sync and multi-reference motion control on RunComfy.

prisma-next
Route vague Prisma Next questions to the right specific workflow skill.

prisma-next-build
Wire Prisma Next into Vite's build system for automatic contract re-emission on save.