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

Zhenzhen GPT Image 2 Fal

4K in ~70 seconds, custom sizes

By T8mars·Created about a year ago·Updated 2 days ago· 740
Zhenzhen GPT Image 2 Fal
  • image1
  • image2
  • image3
  • image4
  • mask
  • images
  • response
  • image_urls
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 flagship image model, and this node reaches it through the fal route - which, on this pack, is the "fast and stable" lane. The README brags and it's mostly earned: 2K and 4K output, 4K in around 70 seconds, effectively unlimited concurrency, and custom resolution support. The catch is the one line buried in the changelog: "注意设置的自定义尺寸一定要被16整除" - your custom width and height must be divisible by 16, or the request fails. Write that down.

Comfly_gpt_image_2_fal does both generate and edit (the mode toggle), and being the fal route it's pre-deduction billing: the relay holds a base amount, then settles the real cost after the job based on quality, input images, and output size.

The inputs that matter

  • prompt and mode (generate or edit) - the two required ones.
  • image1image4 and mask - the edit material when mode is edit. Note the mask here is an IMAGE-typed input (a mask image), not a MASK tensor.
  • image_size - auto, the preset ratios (square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9), or custom. On custom, custom_width and custom_height kick in - up to 3840×2160, and again: both must be multiples of 16.
  • quality - auto, high, medium, low.
  • num_images - 1 to 4.
  • output_format - png, jpeg, webp.
  • image_way - image_url (default) or base64 for how your inputs travel.
  • seed - capped at FAL's 65535 (0 = random). poll_interval and max_poll_attempts control the wait loop; the default 600 × 6s is a full hour of patience.

Outputs: images (IMAGE tensor), response (JSON), image_urls (hosted results).

Install and key

cd ComfyUI/custom_nodes
git clone https://github.com/T8mars/Comfyui-zhenzhen

Restart, or ComfyUI Manager → "Comfyui-zhenzhen". The fal nodes use the same Zhenzhen key - ai.t8star.org - no separate fal.ai account needed; the relay fronts the fal endpoint. Default token group is fine for this lane.

Reality check

The fal lane is the one people actually report as stable for 4K, so if the official-route nodes are giving you white images or timeouts, this is the fallback to try. Watch the billing model: fal is pre-deducted and settles after, so the deduction line isn't the final price - the README flags this explicitly. And as always with this pack: 500s are usually upstream, re-run before debugging, and your prompts and reference images are leaving the machine. The 16-divisibility rule is the one gotcha unique to this node - a 1280×720 custom size is fine, a 1279×720 will waste a credit on an error.

Categoryzhenzhen/Openai

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 (3)

NameTypeDescription
imagesIMAGE
responseSTRING
image_urlsSTRING