ComfyUI Node
Z-Image-Turbo Region Builder KJ
Visual region prompt builder for Z-Image-Turbo. Draw boxes on the canvas, set a prompt, optional negative prompt, strength, and feather per region. The node outputs Z-Image text conditionings with ComfyUI masks, a batch of independent masks, a combined mask for img2img/inpainting, and serialized region data for workflow save/load.
Z-Image-Turbo Region Builder KJ
- clip
- image
- vae
- positive
- negative
- region_masks
- combined_mask
- source_image
- preview
- regions_json
- bboxes
- width
- height
- latent_with_noise_mask
◄width1024►
◄height1024►
◄global_prompt►
◄global_negative_prompt►
◄modetext_to_image►
◄default_region_strength1.00►
◄default_feather16►
◄conditioning_modesingle_prompt_fast►
◄regions_data►
◄bg_brightness35►
◄batch_size1►
CategoryZIT-Ideogram/Z-Image
Inputs (14)
| Name | Type | Default | Description |
|---|---|---|---|
| clip | CLIP | — | |
| width | INT | 102464–16384 | — |
| height | INT | 102464–16384 | — |
| global_prompt | STRING | — | |
| global_negative_prompt | STRING | — | |
| mode | COMBO | text_to_image | 2 options: text_to_image, image_to_image_region_edit |
| default_region_strength | FLOAT | 1.000–10 | Default mask strength for regions. In single_prompt_fast this affects mask/noise_mask outputs, not text prompt strength. For img2img edits keep near 1.0 and control change with KSampler denoise. |
| default_feather | FLOAT | 160–512 | Default mask feather in pixels. 0 = hard rectangle edge, 8-24 = normal soft edge, 32+ = very soft transition. |
| conditioning_mode | COMBO | single_prompt_fast | Recommended: single_prompt_fast. regional_conditioning_slow is experimental for Z-Image-Turbo, often slower and less reliable because ZIT is not designed for masked multi-conditioning. |
| regions_data | STRING | — | |
| bg_brightness | STRING | 35 | Background brightness. String for compatibility with older workflow widget ordering. |
| batch_size | INT | 11–4096 | Batch size for the latent_with_noise_mask output. Kept at the end for workflow compatibility. |
| imageopt | IMAGE | Optional source/reference image shown in the editor and passed through. | |
| vaeopt | VAE | Optional VAE. When provided with an image, the node also outputs an encoded latent with combined_mask as noise_mask for img2img regional edits. |
Outputs (11)
| Name | Type | Description |
|---|---|---|
| positive | CONDITIONING | — |
| negative | CONDITIONING | — |
| region_masks | MASK | — |
| combined_mask | MASK | — |
| source_image | IMAGE | — |
| preview | IMAGE | — |
| regions_json | STRING | — |
| bboxes | BOUNDING_BOX | — |
| width | INT | — |
| height | INT | — |
| latent_with_noise_mask | LATENT | — |