ComfyUI Node
Wan I2V Conditioning Mask Pro
Full-featured pixel-space masking with VAE re-encoding
Wan I2V Conditioning Mask Pro
- positive
- negative
- vae
- image
- mask
- depth_map
- positive
- negative
- mask_out
◄mask_modefull►
◄depth_threshold0.50►
◄fill_brightness0.50►
◄tint_fillfalse►
◄tint_color►
◄mask_strength1.00►
◄grow_mask0.00►
◄feather0.00►
◄invert_maskfalse►
◄text_strength1.00►
◄generate_person_maskfalse►
◄mask_facetrue►
◄mask_hairfalse►
◄mask_bodyfalse►
◄mask_clothesfalse►
◄mask_backgroundfalse►
◄mask_face_ovalfalse►
◄mask_eyesfalse►
◄mask_eyebrowsfalse►
◄mask_lipsfalse►
◄mask_pupilsfalse►
◄mask_nosefalse►
◄mask_cheeksfalse►
◄mask_foreheadfalse►
◄mask_jaw_chinfalse►
◄mask_earsfalse►
◄mask_confidence0.40►
◄refine_mask_detectiontrue►
◄ignore_areanone►
◄ignore_percent0.50►
Categoryconditioning/Wan
Inputs (36)
| Name | Type | Default | Description |
|---|---|---|---|
| positive | CONDITIONING | — | |
| negative | CONDITIONING | — | |
| vae | VAE | — | |
| image | IMAGE | — | |
| maskopt | MASK | Custom mask. White=fill, Black=keep. Overrides depth_map and mask_mode. Tip: LoadImage MASK output can be connected here for alpha masks. | |
| depth_mapopt | IMAGE | Depth map image. White (close)=fill, Black (far)=keep. Overrides mask_mode only. | |
| mask_modeopt | COMBO | full | Preset mask shape. Ignored if mask or depth_map connected. |
| depth_thresholdopt | FLOAT | 0.500–1 | Depth cutoff. 0=use depth as gradient. Higher values=fill more of the foreground. 0.5=fill close objects, keep distant. |
| fill_brightnessopt | FLOAT | 0.500.25–0.75 | Fill brightness for masked regions. Below 0.5=darker generation, above 0.5=brighter. Model doesn't process well outside 0.25-0.75 range. |
| tint_fillopt | BOOLEAN | false | Enable color tint on fill to influence the vibe of generated areas |
| tint_coloropt | STRING | Hex color for tint (e.g. FF8800 for warm orange, 4488FF for cool blue). Leave empty for no tint. | |
| mask_strengthopt | FLOAT | 1.000–1 | Mask intensity. Values below 1 let some original detail bleed through in filled areas, useful for subtle changes. |
| grow_maskopt | FLOAT | 0.00-0.5–0.5 | Expand or shrink the fill region. Positive=grow fill area, negative=shrink. Value is % of mask size (0.05=5% growth relative to masked area). |
| featheropt | FLOAT | 0.000–1 | Blur mask edges for smooth transitions. Value scales from 0 (sharp) to 1 (blur radius ~25% of image). Applied after grow_mask. |
| invert_maskopt | BOOLEAN | false | Flip fill and keep regions. Applied last, after grow_mask, feather, and mask_strength. |
| text_strengthopt | FLOAT | 1.000.5–3 | Scale text conditioning strength. >1.0 boosts text influence for sharper results. |
| generate_person_maskopt | BOOLEAN | false | Enable built-in person/face mask generation using MediaPipe. Highest priority - overrides all other mask sources. |
| mask_faceopt | BOOLEAN | true | Include face skin area in mask (requires generate_person_mask) |
| mask_hairopt | BOOLEAN | false | Include hair in mask (requires generate_person_mask) |
| mask_bodyopt | BOOLEAN | false | Include body/skin in mask (requires generate_person_mask) |
| mask_clothesopt | BOOLEAN | false | Include clothing in mask (requires generate_person_mask) |
| mask_backgroundopt | BOOLEAN | false | Include background in mask (requires generate_person_mask) |
| mask_face_ovalopt | BOOLEAN | false | Full face oval outline. Works best on close-ups or 720p+ resolution. |
| mask_eyesopt | BOOLEAN | false | Both eyes. Works best on close-ups or 720p+ resolution. |
| mask_eyebrowsopt | BOOLEAN | false | Both eyebrows. Works best on close-ups or 720p+ resolution. |
| mask_lipsopt | BOOLEAN | false | Lips/mouth area. Works best on close-ups or 720p+ resolution. |
| mask_pupilsopt | BOOLEAN | false | Pupils only. Works best on close-ups or 720p+ resolution. |
| mask_noseopt | BOOLEAN | false | Nose area. Works best on close-ups or 720p+ resolution. |
| mask_cheeksopt | BOOLEAN | false | Cheek areas. Works best on close-ups or 720p+ resolution. |
| mask_foreheadopt | BOOLEAN | false | Forehead area. Works best on close-ups or 720p+ resolution. |
| mask_jaw_chinopt | BOOLEAN | false | Jaw and chin area. Works best on close-ups or 720p+ resolution. |
| mask_earsopt | BOOLEAN | false | Both ears. Works best on close-ups or 720p+ resolution. |
| mask_confidenceopt | FLOAT | 0.400.01–1 | Detection confidence threshold for person mask generation |
| refine_mask_detectionopt | BOOLEAN | true | Crop and re-run detection for better accuracy on smaller faces |
| ignore_areaopt | COMBO | none | Exclude a region from person/face detection. Use to isolate one person when multiple are in frame. |
| ignore_percentopt | FLOAT | 0.500.1–0.9 | % of image to ignore from selected edge (0.5 = half the image). |
Outputs (3)
| Name | Type | Description |
|---|---|---|
| positive | CONDITIONING | — |
| negative | CONDITIONING | — |
| mask_out | MASK | — |