Eric Qwen-Edit Composite Unify

Compositing is the easy part; making the composite look real is the hard part. You've cut a subject out, dropped it onto a new background, and now the lighting doesn't match, the shadow's missing, and the seam is visible to anyone looking. Eric Qwen-Edit Composite Unify is the "fix it so it looks shot in one go" node - it runs a single Qwen-Image-Edit pass over the composite and lets the model relight, re-shadow, and re-blend the whole image into something coherent.

It's built to sit directly downstream of ImageComposer from the author's companion pack (Eric_Composer_Studio), which is why it accepts a COMPOSER_LAYERS bundle plus seam_mask / foreground_mask inputs. But it works fine with a plain pasted image from any source - you just lose the smart masking.

The three modes, and which one to actually use

• harmonize_only (default, and the README and source both say RECOMMENDED) - sends only the composite to Qwen-Edit with a baked-in harmonization prompt. No segments, no masks, no post-compositing. The model relights the entire image coherently. Start here, always.
• whole - same as harmonize_only but also forwards your original segments (or the relayed composer layers) as extra VL/ref images. The theory is that it keeps each subject's identity straight; the practice is that segments shot under different lighting fight the harmonization. Only switch to this if a subject's identity is being lost.
• seam_inpaint - the advanced one. Qwen runs on the full composite, then the result is composited back over the original through a feathered mask so untouched regions stay pixel-identical. This is the answer when you need the pixels outside the edit to not move (Qwen-Edit re-emits the whole frame, so harmonize_only shifts everything a little). It needs well-aligned masks; the author's own words are that misaligned masks produce "dissolved subjects or halos."

The inputs you'll touch

• composite_image (required) - the collage to fix.
• mode - the dropdown above.
• user_prompt / prompt_mode - optional extra instruction. append tacks your words onto the baked preamble; replace lets you throw the preamble away and write your own.
• composer_layers and the mask inputs (seam_mask, foreground_mask, manual_mask) - only relevant for seam_inpaint, and mostly only if you came from ImageComposer. manual_mask overrides everything else if you'd rather hand-paint the region.
• seam_dilate_px, subject_protect, ground_contact_px, seam_feather_px - seam shaping for seam_inpaint. subject_protect (default True) keeps the seam band outside each subject's silhouette so subject pixels stay identical; ground_contact_px (48) extends a strip below subjects so the model can paint cast shadows and ground contact. Leave these alone until the default results bug you.
• steps / true_cfg_scale / seed / max_mp - shared controls. Note the tooltip's advice: keep true_cfg_scale low (2.5-3.0) for harmonization, because high CFG over-applies the prompt and can make Qwen delete out-of-place subjects.

Outputs are image and used_mask (the mask the node actually used, which is handy for debugging seam_inpaint).

Realistic expectations

This is a fix-up pass over a model that re-emits whole frames, so it's not a magic "un-paste" button - for surgical seam repair where nothing else may move, seam_inpaint is the mode, and for everything else harmonize_only beats it on speed and cleanliness. It's also the wrong tool if your composite is fundamentally broken (subject lighting from outer space); the model harmonizes, it doesn't resurrect. Install: ComfyUI Manager search "Eric Qwen Edit", or git clone https://github.com/EricRollei/Eric_Qwen_Edit_Experiments into custom_nodes/, with the Qwen-Image-Edit model loaded by Eric Qwen-Edit Loader upstream.