Nodes/Comfyui-zhenzhen/Concurrent Submit | zhenzhen-mai-image-2.5-edit-fal
ComfyUI Node

Concurrent Submit | zhenzhen-mai-image-2.5-edit-fal

The edit node with a queue

By T8mars·Created about a year ago·Updated 2 days ago· 740
Concurrent Submit | zhenzhen-mai-image-2.5-edit-fal
  • image1
  • image2
  • image3
  • image4
  • task
prompt
image_urls
api_key
num_images1
aspect_ratioauto
output_formatpng
sync_modefalse
image_waybase64
poll_interval6
max_poll_attempts600
skip_errorfalse
seed0

MAI Image 2.5 is the image edit workhorse in Microsoft's MAI lineup, and this is the Concurrent Submit twin of zhenzhen-mai-image-2.5-edit-fal: a fal-hosted, instruction-based image editor where you feed in a photo and a prompt and it redoes the picture - swap the outfit, change the lighting, remove the background, whatever you can describe. The edit API is a "batch this" workflow waiting to happen, and that's exactly what the Submit twin enables: up to 30 of these in the shared image pool, all editing at once.

The inputs that matter

  • prompt - required, and it's the whole game here. Precise instructions ("replace the red coat with a denim jacket, keep everything else") get dramatically better edits than vague ones.
  • image1–image4 - up to four input images as ComfyUI tensors. This is the "here's the photo, edit it" slot.
  • image_urls - the tooltip says it plainly: "Optional external image URLs, one per line." Use this when your source images are already hosted and you'd rather skip the base64 upload.
  • image_way - base64 vs image_url, matches whatever you're feeding in.
  • num_images - 1 to 4 output variants per job. Handy when you want a few takes of the same edit and don't want to pay the round-trip four times... except you're paying per image anyway, so it's a convenience, not a saving.
  • aspect_ratio - auto plus the usual set.
  • output_format - png / jpeg / webp.
  • sync_mode - force a synchronous response instead of the async poll.
  • poll_interval / max_poll_attempts, api_key, seed, skip_error - the standard pack quartet.

The concurrent flow

Output is a single task (COMFLY_IMAGE_FUTURE), not images. So the real workflow is: a row of these Submit nodes - one per photo, or several per photo with different prompts - each task wired into ComflyConcurrent_Image_Await (30 slots). The collector waits for the whole batch, returns the images in slot order, and adds a status JSON so you can see which slot failed. Batch of eight product photos getting the same background cleanup is the canonical use; that's one queue, one collector, thirty seconds of your attention instead of eight babysat runs.

Install and gotchas

It ships in T8mars/Comfyui-zhenzhen - ComfyUI Manager → search "Comfyui-zhenzhen", or git clone https://github.com/T8mars/Comfyui-zhenzhen into custom_nodes, then restart. No local models; standard Python deps. Paid token from the Zhenzhen store, overseas servers (proxy if you're in China), and fal billing is pre-charge-then-settle. Remember you're sending your images to a third-party server for every edit - fine for stock-style batch work, think twice before shipping anything sensitive through it.

Categoryzhenzhen/FAL/Concurrent Submit

Inputs (16)

NameTypeDefaultDescription
promptSTRING
image1optIMAGE
image2optIMAGE
image3optIMAGE
image4optIMAGE
image_urlsoptSTRINGOptional external image URLs, one per line.
api_keyoptSTRING
num_imagesoptINT11–4
aspect_ratiooptCOMBOauto8 options: auto, 1:1, 4:3, 3:4, 16:9, 9:16, +2
output_formatoptCOMBOpng3 options: png, jpeg, webp
sync_modeoptBOOLEANfalse
image_wayoptCOMBObase642 options: base64, image_url
poll_intervaloptINT61–60
max_poll_attemptsoptINT60010–3600Default 600*6s = 3600s timeout.
skip_erroroptBOOLEANfalse
seedoptINT00–18446744073709550000Execution seed for ComfyUI cache control. Fixed reuses the cached result; randomize/increment/decrement requests a new run. This compatibility seed is not sent to APIs that do not expose a native seed parameter.

Outputs (1)

NameTypeDescription
taskCOMFLY_IMAGE_FUTURE