并发提交|Zhenzhen Image GK v2 文生图
GK v2 text-to-image, batched
- api_config
- future
If you want to understand how the concurrent submit pattern works without any of the model-switching complexity, this is the node to study, because it's the plainest one in the entire 并发提交 family. Zhenzhen Image GK v2 文生图 - the concurrent submit version - is a pure text-to-image node with exactly three required inputs and one reference-free job: turn a prompt into a batch of images, in parallel.
The inputs:
prompt- required, up to 20,000 characters.size- the output aspect ratio dropdown (the brief shows1:1as default; the GK v2 T2I family supports the usual ratios).n- 1 to 12 images per request. Note the range: this node goes to 12, one more than most of the pack's image nodes.
Plus the standard api_config, skip_error, and the ComfyUI cache seed. No reference image slots at all - that's what makes it so clean. Output is the single future (SEEDANCE_IMAGE_FUTURE), which goes into 并发接收图片(30 路).
How it works
The concurrent pattern, distilled: your settings are validated immediately, then the render is handed to the image thread pool (up to 30 workers; shrink with SEEDANCE_IMAGE_CONCURRENCY) and you get the future back instantly. The receiver waits on every connected slot in parallel, returns images in slot order, and lets you pick failure_mode=raise or placeholder. Per-slot skip_error keeps one dud prompt from killing the batch. Since there are no references to upload, this is also the fastest node in the family to get moving - upload is a zero-step.
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 plus an api.seedance.nz key; nothing to download.
Where people get burned
- The
futureoutput catches everyone once. It is not an image - it goes into the receiver node'sfuture_1…future_30slots. Until you've internalized that, you'll keep trying to wire it intoSave Image. nvs parallel slots. Withn=12on one node you get 12 images from one request; with 12 submit nodes you get 12 independent renders you can vary (prompt, seed, size). Both are legitimate, they just answer different questions.- No references here. If your workflow suddenly needs image editing, this isn't the node - the GK v2 edit and region-edit submit nodes are separate, because the API structures their requests completely differently.
This is the node I'd point a beginner at to learn the concurrent flow: three inputs, one future, and the whole batch pattern in one glance. Cost is per image, so n on the cheap tier and parallel only when you're actually comparing variations.
Inputs (6)
| Name | Type | Default | Description |
|---|---|---|---|
| prompt | STRING | Text-to-image prompt, up to 20000 characters. | 文生图提示词,最多 20000 字符。 | |
| size | COMBO | 1:1 | Output aspect ratio. | 输出画面比例。 |
| n | INT | 11–12 | Number of images requested, 1 to 12; the node downloads the primary result. | 请求 1 到 12 张,节点下载主结果。 |
| api_configopt | SEEDANCE_CONFIG | Connect Seedance API Config; otherwise SEEDANCE_API_KEY is used. | |
| skip_erroropt | BOOLEAN | false | On failure return a placeholder image instead of stopping the workflow. | 失败时输出占位图片而不中断工作流。 |
| seedopt | INT | 00–18446744073709550000 | ComfyUI cache seed. Fixed reuses the cached result while all other inputs stay unchanged; randomize/increment/decrement starts a new execution. This value is not sent to models without documented seed support. | ComfyUI 缓存种子;Fixed 在其他输入不变时复用缓存,随机、递增或递减会触发新任务。未声明支持 seed 的模型不会收到此参数。 |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| future | SEEDANCE_IMAGE_FUTURE | — |