zhenzhen-luma-uni-1-v1-fal
Text-to-image and edit in one node, up to nine reference images
- image
- reference_image1
- reference_image2
- reference_image3
- reference_image4
- images
- response
- image_urls
Luma made its name on video (Dream Machine, then Ray), so its image model "Uni 1" is the quiet sibling - but it's a good one, and this node exposes it in full: text-to-image, a _max quality tier, an edit mode (with up to nine reference images for the edit), manga style, web search for the text-to-image pass, and a proper aspect-ratio ladder from 3:1 down to 1:3. It's the pack's most complete image node, even though the model it wraps doesn't get the press.
The realistic use: an all-in-one image node that can generate and edit, with Luma's clean editorial look. The edit modes take an image plus up to nine references and follow an instruction; the text_to_image modes are straight generation with optional enable_web_search (which lets the model pull current references - a genuinely rare toggle in API image nodes).
How it works
mode picks the task: text_to_image, text_to_image_max, edit, edit_max. The _max variants are the higher-quality (and pricier) tier. For edit modes, wire image (the base) and optionally reference_image1–4 or up to nine URLs in reference_image_urls. style is auto or manga (yes, Luma Uni can do manga style). Submit, poll, download, and get back images (IMAGE), response, image_urls.
Note the aspect-ratio ladder is the unusual part: auto, 3:1, 2:1, 16:9, 3:2, 1:1, 2:3, 9:16, 1:2, 1:3. Ultra-wide and ultra-tall are both available, which most image nodes skip.
Inputs that matter (the short list)
mode- text_to_image to generate,editto modify an existing image.prompt- for edit modes this is the instruction ("change the background to a desert at sunset").image+reference_image*- the edit base and the reference set.enable_web_search- text-to-image only (the tooltip is explicit); on, it grounds the generation in search results.
Installing it
Manager → search Comfyui-zhenzhen → install, or:
cd ComfyUI/custom_nodes
git clone https://github.com/T8mars/Comfyui-zhenzhen
Restart, paste your api_key into the widget. No model downloads.
Common issues
enable_web_searchdoing nothing - it's text-to-image only, per the tooltip; it's ignored in edit modes.- Nine references overwhelming the edit - schema supports it, quality rarely does. Like every reference-heavy node in this pack, the strong 2–4 beat the kitchen sink.
_maxcost creep - the max tier is noticeably pricier; iterate on the base mode, export on max.- The pack standard gotchas - empty key, 443/VPN-in-TUN-mode for the overseas API, vendor 500s needing a re-run, fal's pre-deducted billing, cache-only seed.
One aside: Uni 1 is a "closed model, so call it" situation - no local path exists. If Luma's clean editorial look is what you need and you're already in this pack, it's a solid mid-priced image node with a wider aspect-ratio range than anything else here.
Inputs (19)
| Name | Type | Default | Description |
|---|---|---|---|
| prompt | STRING | A clean editorial image with strong composition. | — |
| modeopt | COMBO | text_to_image | 4 options: text_to_image, text_to_image_max, edit, edit_max |
| imageopt | IMAGE | — | |
| reference_image1opt | IMAGE | — | |
| reference_image2opt | IMAGE | — | |
| reference_image3opt | IMAGE | — | |
| reference_image4opt | IMAGE | — | |
| image_urlopt | STRING | — | |
| reference_image_urlsopt | STRING | Optional reference image URLs, one per line. Max 9. | |
| api_keyopt | STRING | — | |
| aspect_ratioopt | COMBO | 16:9 | 10 options: auto, 3:1, 2:1, 16:9, 3:2, 1:1, +4 |
| output_formatopt | COMBO | png | 3 options: auto, png, jpeg |
| styleopt | COMBO | auto | 2 options: auto, manga |
| enable_web_searchopt | BOOLEAN | false | Text-to-image modes only. |
| image_wayopt | COMBO | base64 | 2 options: base64, image_url |
| poll_intervalopt | INT | 61–60 | — |
| max_poll_attemptsopt | INT | 60010–3600 | Default 600*6s = 3600s timeout. |
| skip_erroropt | BOOLEAN | false | — |
| seedopt | INT | 00–18446744073709550000 | Execution 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 (3)
| Name | Type | Description |
|---|---|---|
| images | IMAGE | — |
| response | STRING | — |
| image_urls | STRING | — |