Concurrent Submit | Zhenzhen Seedance 2.0 Ref2Video Fal
Images, clips and audio in one prompt
- image1
- image2
- image3
- image4
- image5
- image6
- image7
- image8
- image9
- task
Seedance 2.0's reference-to-video mode, served through fal's queue. The "Ref2Video" name is the point: this node can take up to nine reference images, three reference videos, and three reference audio clips in a single generation, and you address them from the prompt with the pack's @ syntax - @Video1 in your prompt means "use reference video #1," @Audio1 means "use reference audio #1." That's the tool you want when you're trying to keep a character, a motion style, or a voice consistent across generated clips.
It's a video node, so: shared video pool (10 workers), COMFLY_VIDEO_FUTURE task output, and Concurrent Collect Videos (ComflyConcurrent_Video_Await) is your mandatory partner - up to 10 tasks, returned as video_1…video_10 in order. The submit node itself never blocks; the waiting happens in the collector, in parallel.
The inputs
- prompt - your direction, including the
@Video1/@Audio1-style references. The tooltips on the reference URL fields spell out the syntax. - image1 … image9 - still references (frames, character shots, style boards).
- video_url1 … video_url3 - reference clips as hosted URLs (MP4/MOV).
- audio_url1 … audio_url3 - reference audio (MP3/WAV), e.g. for a voice or sound to carry over.
- resolution - 480p / 720p / 1080p.
- duration -
autoor 4–14 seconds. - aspect_ratio - auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.
- generate_audio - on by default; Seedance will synthesize synchronized sound (sfx, ambient, even lip-sync) for the output.
- seed - fal max 65535, 0 = random.
- image_way -
image_urlorbase64for the stills. - poll_interval / max_poll_attempts - default 600 × 6s = 1 hour.
Install
cd ComfyUI/custom_nodes
git clone https://github.com/T8mars/Comfyui-zhenzhen
Or ComfyUI Manager → search Comfyui-zhenzhen → restart, token into api_key (ai.t8star.org overseas; api.seedance.nz for the domestic discount).
Gotchas
- The
@syntax is mandatory, not decorative. Feeding reference slots and not referencing them in the prompt is a common way to get a generation that ignores your refs. Address them explicitly. - Reference videos cost like output. Seedance counts reference clip seconds toward the price - the pack's own changelog calls this out. Trim refs to what you actually need.
- Timeouts with heavy references are realistic. Nine images + three clips + audio is a slow job. If it times out at the 1-hour default, check the async-task page before resubmitting - and remember fal lanes are pre-deducted and settled later.
Inputs (26)
| Name | Type | Default | Description |
|---|---|---|---|
| prompt | STRING | — | |
| image1opt | IMAGE | — | |
| image2opt | IMAGE | — | |
| image3opt | IMAGE | — | |
| image4opt | IMAGE | — | |
| image5opt | IMAGE | — | |
| image6opt | IMAGE | — | |
| image7opt | IMAGE | — | |
| image8opt | IMAGE | — | |
| image9opt | IMAGE | — | |
| video_url1opt | STRING | Reference video URL 1 (MP4/MOV). Use @Video1 in prompt. | |
| video_url2opt | STRING | Reference video URL 2 (MP4/MOV). Use @Video2 in prompt. | |
| video_url3opt | STRING | Reference video URL 3 (MP4/MOV). Use @Video3 in prompt. | |
| audio_url1opt | STRING | Reference audio URL 1 (MP3/WAV). Use @Audio1 in prompt. | |
| audio_url2opt | STRING | Reference audio URL 2 (MP3/WAV). Use @Audio2 in prompt. | |
| audio_url3opt | STRING | Reference audio URL 3 (MP3/WAV). Use @Audio3 in prompt. | |
| api_keyopt | STRING | — | |
| resolutionopt | COMBO | 720p | 3 options: 480p, 720p, 1080p |
| durationopt | COMBO | auto | 13 options: auto, 4, 5, 6, 7, 8, +7 |
| aspect_ratioopt | COMBO | auto | 7 options: auto, 21:9, 16:9, 4:3, 1:1, 3:4, +1 |
| generate_audioopt | BOOLEAN | true | Generate synchronized audio (sound effects, ambient, lip-sync). |
| seedopt | INT | 00–65535 | 0 = random seed. FAL seed max is 65535. |
| image_wayopt | COMBO | image_url | 2 options: image_url, base64 |
| poll_intervalopt | INT | 62–30 | — |
| max_poll_attemptsopt | INT | 60010–3600 | Default 600*6s = 1 hour timeout. |
| skip_erroropt | BOOLEAN | false | 开启后,节点失败时不报错、返回默认空结果。 |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| task | COMFLY_VIDEO_FUTURE | — |