MediaPipeFaceMask - ComfyUI Built-in Node Documentation

Overview

This node creates a binary mask (a black and white image) based on face landmarks detected by MediaPipe. It draws filled polygon shapes for each detected face region, producing one mask per frame in a batch. When multiple faces are detected in the same frame, their masks are combined into a single mask.

Inputs

Parameter	Description	Data Type	Required	Range
`face_landmarks`	The face landmarks data from a MediaPipe face detection node.	FACE_LANDMARKS	Yes	-
`regions`	Selects which facial regions to include in the mask. `"all"` creates a mask from the union of all face regions (face oval, lips, eyes, irises). `"custom"` allows you to toggle each region individually. Default: `"all"`	COMBO	Yes	`"all"` `"custom"`

When regions is set to "custom", the following additional boolean parameters become available:

Parameter	Description	Data Type	Required	Range
`face_oval`	Include the face oval region in the mask. Default: True	BOOLEAN	No	True/False
`lips`	Include the lips region in the mask. Default: True	BOOLEAN	No	True/False
`eyes`	Include the eyes region in the mask. Default: True	BOOLEAN	No	True/False
`irises`	Include the irises region in the mask. Default: True	BOOLEAN	No	True/False

Note: When using "all" mode, the mask includes all regions combined. Since the face oval encloses the other regions, selecting "all" effectively produces the same result as selecting only the face oval.

Outputs

Output Name	Description	Data Type
`MASK`	A binary mask tensor where face regions are white (value 1.0) and background is black (value 0.0). The mask has the same dimensions as the input image and contains one mask per frame in the batch.	MASK

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

Source fingerprint (SHA-256): 92270002a42ed59bc75e676a6881e1899186d3c8a1bb4dd4c0d39b3762b5bb66

MediaPipeFaceLandmarker - ComfyUI Built-in Node Documentation

MediaPipeFaceMeshVisualize - ComfyUI Built-in Node Documentation

​Overview

​Inputs

​Outputs

Overview

Inputs

Outputs