并发提交|Zhenzhen Video V3.1
Zhenzhen Video V3.1, the 8-second one — fast, quality, or lite, all in a batch
- image1
- image2
- image3
- api_config
- future
The Zhenzhen Video V3.1 concurrent submit node is the pack's fixed-duration video batcher: every model in it renders 8 seconds, and your only real choices are which of the three variants and which reference images. The model dropdown:
zhenzhen-video-v31-fast(default) - the speed tier, up to 3 reference images.zhenzhen-video-v31-quality- the quality tier, up to 2 reference images.zhenzhen-video-v31-lite- the minimal tier: no images at all, text-only.
That per-model image cap is the thing to respect. The fast model takes three, quality takes two, lite takes zero, and the node will reject the wrong combination. This is the pack's clearest example of "the model you pick defines the input surface," which matters when you're filling ten slots at once and don't want to discover slot 8 is invalid.
Shared inputs: prompt (up to 20,480 chars), seconds (fixed at 8, still shown as a control), resolution (720p/1080p/4k per the README), ratio (16:9 default, forwarded as metadata.ratio), negative_prompt (optional, forwarded), seed (-1 = random, non-negative forwarded to metadata.seed), plus image1 … image3, api_config, and skip_error. Output is the single future (SEEDANCE_VIDEO_FUTURE) into 并发接收视频(10 路).
How it works
Same concurrent machinery as the rest of the family - preflight against the selected model (this is where the image-count rule bites), video thread pool (10 workers; SEEDANCE_VIDEO_CONCURRENCY), future returned - over the /v1/videos endpoint. References upload and submit as images[]; the receiver gathers all slots in parallel, in order, with per-slot skip_error and its own failure_mode. Mixing a V3.1 future with any other video future is fine.
Installing it
ComfyUI Manager → search ComfyUI Seedance, or:
cd ComfyUI/custom_nodes
git clone https://github.com/T8mars/ComfyUI_Seedance.git
python -m pip install -r ComfyUI_Seedance/requirements.txt
Restart, look under Seedance/并发提交. requests and an api.seedance.nz key; nothing to download.
Where people get burned
- The image caps are per-model and enforced. Wire three images into a
liteslot and the preflight stops you cold. Pick the model first, then count your references. - 8 seconds is the whole duration. There's no 4-or-15 knob here; every clip is 8s. If your storyboard beat needs 4s, this isn't the node.
- Batch discipline. Ten parallel 8-second clips is a real bill. The
fasttier exists for iteration; use it, and fix yourseedper slot if you want comparisons that mean anything. futureis not a video. Receiver node, thenSaveVideo.
Standing fine print: metered per clip, expiring links, data leaves the machine. V3.1 is the shop's "proper video" family - a fixed 8-second format is actually handy when you're batching, because every slot lands the same length and the receiver output lines up cleanly.
Inputs (12)
| Name | Type | Default | Description |
|---|---|---|---|
| model | COMBO | zhenzhen-video-v31-fast | Zhenzhen video model. | Zhenzhen 视频模型。 |
| prompt | STRING | Text prompt, up to 20480 chars. In multimodal mode you can reference materials as @Image 1 / @Video 1 / @Audio 1. | 文本提示词,多模态可用 @Image 1、@Video 1 指代第几个素材。 | |
| seconds | COMBO | 8 | Video duration in seconds, submitted as a string. | 视频时长,按字符串提交。 |
| resolution | COMBO | 720p | Target resolution. | 目标分辨率。 |
| ratio | COMBO | 16:9 | Optional aspect ratio forwarded as metadata.ratio. | 可选画幅比例,透传为 metadata.ratio。 |
| negative_prompt | STRING | Optional negative prompt forwarded to metadata. | 可选反向提示词,透传到 metadata。 | |
| seed | INT | -1-1–2147483647 | -1 = random seed; non-negative values are forwarded to metadata.seed. | -1 表示随机种子,非负整数透传到 metadata.seed。 Fixed reuses the cached result while all inputs stay unchanged; randomize/increment/decrement starts a new execution. | Fixed 在输入不变时复用缓存;随机、递增或递减会触发新任务。 |
| image1opt | IMAGE | Optional reference image 1; connected images are submitted as images[]. | 可选参考图 1,连接后通过 images[] 提交。 | |
| image2opt | IMAGE | Optional reference image 2; connected images are submitted as images[]. | 可选参考图 2,连接后通过 images[] 提交。 | |
| image3opt | IMAGE | Optional reference image 3; connected images are submitted as images[]. | 可选参考图 3,连接后通过 images[] 提交。 | |
| api_configopt | SEEDANCE_CONFIG | Connect Seedance API Config; otherwise SEEDANCE_API_KEY is used. | |
| skip_erroropt | BOOLEAN | false | On failure return a placeholder error video instead of stopping the workflow. | 失败时输出占位错误视频。 |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| future | SEEDANCE_VIDEO_FUTURE | — |