RP Regional Detailer (Qwen)
A thin, clever wrapper
- image
- model
- clip
- vae
- regional_prompts_nolora
- regional_lora_map
- negative
- divide_mode
- divide_ratio
- image
- debug_image
What it is
The Qwen variant of the regional detailer, and it's honest about being one: RP Regional Detailer (Qwen) delegates entirely to the Z-Image detailer. Qwen-Image and Z-Image share enough of the latent/VAE family that the same 16-channel crop-and-inpaint pipeline works for both. The one structural difference is a quiet piece of engineering - Qwen's VAE can return a 5D tensor shaped [B, T, H, W, C], which the node normalizes to 4D [B, H, W, C] before it hits the sampler. If you've ever seen a "5D tensor" error from other Qwen nodes, this one already handles it.
What you'd set
Because it inherits the Z-Image pipeline, the model-specific advice shifts a little:
- steps: 15~20, not Z-Image's 6~10. Qwen isn't Turbo-distilled the way Z-Image is.
- cfg: 1.0 - recommended for Qwen's distilled variants. The usual distilled-model rule applies: CFG fights the model.
- denoise: 0.35–0.55, same as the other detailers.
- shift: the AuraFlow sigma shift, for Qwen.
- Everything else -
bbox_model,detect_threshold,scale_to_pixel,use_base/use_common- mirrors the Z-Image node, including the YOLO file inmodels/ultralytics/bbox/and the same optionaldivide_mode/divide_ratioinputs.
The wiring
Standard RP chain: RPPromptParser → RPRatioParser → a plain KSampler (fine for Qwen) → this node with model/clip/vae plus a negative CONDITIONING. Outputs are image and debug_image. Region prompts are encoded as COMMON + BASE + DIV, same as every detailer in the pack - no scene-narrative merging.
The honest review
If you only run Qwen, this is the node you reach for, and the delegation means it stays maintained in lockstep with the Z-Image detailer. It's also a tidy illustration of how the pack thinks about architecture: one YOLO assignment and one inpaint pipeline, re-skinned per model family with the right latent shape, step count, and CFG. Don't expect Qwen-specific tuning beyond that - the value is that the whole regional stack now has a working Qwen path at all. Dependencies are the same trio as Z-Image: ultralytics, opencv-python, onnxruntime.
Inputs (29)
| Name | Type | Default | Description |
|---|---|---|---|
| image | IMAGE | — | |
| model | MODEL | — | |
| clip | CLIP | — | |
| vae | VAE | — | |
| regional_prompts_nolora | RP_SUBPROMPTS | — | |
| regional_lora_map | RP_LORA_MAP | — | |
| negative | CONDITIONING | — | |
| seed | INT | 00–18446744073709550000 | — |
| steps | INT | 201–100 | Qwen recommended: 15~20 steps. |
| cfg | FLOAT | 1.00–30 | CFG=1.0 recommended for Qwen distilled. |
| sampler_name | COMBO | 44 options: euler, euler_cfg_pp, euler_ancestral, euler_ancestral_cfg_pp, heun, heunpp2, +38 | |
| scheduler | COMBO | 9 options: simple, sgm_uniform, karras, exponential, ddim_uniform, beta, +3 | |
| denoise | FLOAT | 0.500–1 | img2img denoise strength. 0.35~0.55 recommended. |
| feather | INT | 00–64 | Feather radius in pixels. Applied after dilation. |
| noise_mask | BOOLEAN | true | Apply noise mask to latent before sampling. |
| force_inpaint | BOOLEAN | true | Force inpainting mode. |
| shift | FLOAT | 3.00–20 | AuraFlow sigma shift for Qwen. |
| bbox_model | COMBO | 2 options: bbox/person_yolov8m-seg.pt, segm/person_yolov8m-seg.pt | |
| detect_threshold | FLOAT | 0.300.1–1 | YOLO detection confidence threshold. |
| drop_size | INT | 101–16384 | Minimum detection size (px). |
| mask_padding | INT | 320–256 | — |
| mask_blur | INT | 80–64 | — |
| mask_dilation | INT | 40–64 | — |
| scale_to_pixel | INT | 102464–4096 | Target pixel size for upscaling. Masks smaller than this are upscaled before inpainting. Masks larger than this are processed as-is. |
| use_baseopt | BOOLEAN | false | Prepend BASE prompt to each COL prompt. |
| use_commonopt | BOOLEAN | true | — |
| divide_modeopt | RP_DIV_MODE | Horizontal | Connect divide_mode from RPPromptParser. |
| divide_ratioopt | RP_DIV_RATIO | Connect divide_ratio from RPPromptParser. | |
| debugopt | BOOLEAN | false | Print debug log when enabled. |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| image | IMAGE | — |
| debug_image | IMAGE | — |