Nodes/Comfyui-zhenzhen/Concurrent Submit | Zhenzhen GPT Image 2 Fal
ComfyUI Node

Concurrent Submit | Zhenzhen GPT Image 2 Fal

GPT Image 2 on fal — the fast 4K channel, now concurrent

By T8mars·Created about a year ago·Updated 3 days ago· 749
Concurrent Submit | Zhenzhen GPT Image 2 Fal
  • image1
  • image2
  • image3
  • image4
  • mask
  • task
◄prompt—►
◄modeedit►
◄api_key►
◄qualityauto►
◄image_sizecustom►
◄custom_width3840►
◄custom_height2160►
◄num_images1►
◄output_formatpng►
◄image_wayimage_url►
◄seed0►
◄poll_interval6►
◄max_poll_attempts600►
◄skip_errorfalse►

GPT Image 2 is OpenAI's current image model, and this node is the pack's fal-hosted channel for it - the one the README bills as fast, stable, and 4K-capable with unlimited concurrency. The -fal suffix means the job runs through fal's queue API on the author's reseller backend, and per the pack's notes it's pre-charge: credits are withheld on submit and settled when the job finishes. Where the official-channel GPT Image 2 nodes can be slow and rate-limited, this channel was added specifically as the fast backup - the README claims 4K in about 70 seconds.

The Concurrent Submit wrapper is a natural fit: "unlimited concurrency" is only useful if you can actually fire a pile of jobs at once, and that's exactly what this node does.

How the concurrent bit works

The plain Comfly_gpt_image_2_fal node blocks until fal returns. The Submit variant runs it in the pack's shared image pool (30 workers) and returns a task immediately. Collect via Concurrent Collect Images (30): wire task_1 … and the collector waits for the batch, returning images in slot order plus a status string. failure_mode = fail-fast (default) or placeholder.

The inputs that matter

  • prompt (required) - the description or edit instruction.
  • mode - generate or edit. In edit mode, connect images (and optionally a mask).
  • image1 … image4 - reference images for edits.
  • mask - optional inpainting mask.
  • quality - high/medium/low/auto.
  • image_size - auto, the standard presets, or custom. Custom unlocks custom_width / custom_height up to 3840 - must be multiples of 16, or the call errors. Defaults are 3840×2160, i.e. a 4K canvas.
  • num_images - 1–4 per call.
  • image_way - image_url (default) or base64 for how references are uploaded.
  • seed - fal caps at 65535; 0 = random.
  • poll_interval (6s) / max_poll_attempts (600 → 3600s ceiling) - fal polling knobs.

Output: one task (COMFLY_IMAGE_FUTURE) → Collector → images.

Installing it

Ships in Comfyui-zhenzhen:

  • ComfyUI Manager → Install Custom Nodes → search "Comfyui-zhenzhen" → install → restart.
  • Or cd ComfyUI/custom_nodes && git clone https://github.com/T8mars/Comfyui-zhenzhen and restart.

No model downloads. You need a paid token from the author's storefront (ai.t8star.org), in api_key.

Gotchas

The README is explicit on three points. First, fal is pre-withheld: don't be alarmed when a job's hold is bigger than the final charge. Second, the custom-size rule - must divide by 16 - is the #1 cause of "it just errored" for people chasing specific resolutions. Third, this fal channel was the fix for the official GPT Image 2 channel's congestion, so if the official nodes are slow, this is the one to reach for. The seed cap (65535, 0 = random) also trips people up when porting seeds from other nodes. Standard pack note: overseas endpoint needs a proxy from mainland China.

Categoryzhenzhen/Openai/Concurrent Submit

Inputs (19)

NameTypeDefaultDescription
promptSTRING—
modeCOMBOedit2 options: generate, edit
image1optIMAGE—
image2optIMAGE—
image3optIMAGE—
image4optIMAGE—
maskoptIMAGE—
api_keyoptSTRING—
qualityoptCOMBOauto4 options: high, medium, low, auto
image_sizeoptCOMBOcustom8 options: auto, square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, +2
custom_widthoptINT3840256–3840Custom width (must be multiple of 16). Only used when image_size='custom'.
custom_heightoptINT2160256–3840Custom height (must be multiple of 16). Only used when image_size='custom'.
num_imagesoptINT11–4—
output_formatoptCOMBOpng3 options: png, jpeg, webp
image_wayoptCOMBOimage_url2 options: image_url, base64
seedoptINT00–655350 = random seed. FAL seed max is 65535.
poll_intervaloptINT61–60—
max_poll_attemptsoptINT60010–3600Default 600*6s = 3600s timeout.
skip_erroroptBOOLEANfalse开启后,节点失败时不报错、返回默认空结果;关闭时(默认)失败直接抛出错误。

Outputs (1)

NameTypeDescription
taskCOMFLY_IMAGE_FUTURE—