Nodes/ComfyUI Seedance/并发提交|Zhenzhen Video V3.1
ComfyUI Node

并发提交|Zhenzhen Video V3.1

Zhenzhen Video V3.1, the 8-second one — fast, quality, or lite, all in a batch

By T8mars·Created 2 months ago·Updated 3 days ago· 31
并发提交|Zhenzhen Video V3.1
  • image1
  • image2
  • image3
  • api_config
  • future
modelzhenzhen-video-v31-fast
prompt
seconds8
resolution720p
ratio16:9
negative_prompt
seed-1
skip_errorfalse

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 image1image3, 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 lite slot 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 fast tier exists for iteration; use it, and fix your seed per slot if you want comparisons that mean anything.
  • future is not a video. Receiver node, then SaveVideo.

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.

CategorySeedance/并发提交

Inputs (12)

NameTypeDefaultDescription
modelCOMBOzhenzhen-video-v31-fastZhenzhen video model. | Zhenzhen 视频模型。
promptSTRINGText prompt, up to 20480 chars. In multimodal mode you can reference materials as @Image 1 / @Video 1 / @Audio 1. | 文本提示词,多模态可用 @Image 1、@Video 1 指代第几个素材。
secondsCOMBO8Video duration in seconds, submitted as a string. | 视频时长,按字符串提交。
resolutionCOMBO720pTarget resolution. | 目标分辨率。
ratioCOMBO16:9Optional aspect ratio forwarded as metadata.ratio. | 可选画幅比例,透传为 metadata.ratio。
negative_promptSTRINGOptional negative prompt forwarded to metadata. | 可选反向提示词,透传到 metadata。
seedINT-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 在输入不变时复用缓存;随机、递增或递减会触发新任务。
image1optIMAGEOptional reference image 1; connected images are submitted as images[]. | 可选参考图 1,连接后通过 images[] 提交。
image2optIMAGEOptional reference image 2; connected images are submitted as images[]. | 可选参考图 2,连接后通过 images[] 提交。
image3optIMAGEOptional reference image 3; connected images are submitted as images[]. | 可选参考图 3,连接后通过 images[] 提交。
api_configoptSEEDANCE_CONFIGConnect Seedance API Config; otherwise SEEDANCE_API_KEY is used.
skip_erroroptBOOLEANfalseOn failure return a placeholder error video instead of stopping the workflow. | 失败时输出占位错误视频。

Outputs (1)

NameTypeDescription
futureSEEDANCE_VIDEO_FUTURE