MediaPipeFaceLandmarker - ComfyUI Built-in Node Documentation

Overview

Detects faces in an image and identifies 468 facial landmarks (key points) on each face using MediaPipe’s BlazeFace and FaceMesh models. It also calculates ARKit-52 blendshape coefficients for facial expression analysis. The node can process multiple images in a batch and outputs both the landmark data and bounding boxes for each detected face.

Inputs

Parameter	Description	Data Type	Required	Range
`face_detection_model`	The MediaPipe face detection model to use for landmark detection.	FACE_DETECTION_MODEL	Yes
`image`	The input image or batch of images to detect faces in.	IMAGE	Yes
`detector_variant`	Face detector range. `"short"` is tuned for close-up faces (within ~2 m of the camera); `"full"` covers farther/smaller faces (up to ~5 m) but is slower. `"both"` runs both detectors and keeps whichever found more faces per frame (~2x detection cost). Default: `"short"`.	COMBO	Yes	`"short"` `"full"` `"both"`
`num_faces`	Maximum number of faces to return per frame. 0 means no cap (return all detected). Default: 1.	INT	Yes	0 to 16
`min_confidence`	BlazeFace score threshold. Lower values help catch small or occluded faces. Default: 0.5.	FLOAT	No	0.00 to 1.00
`missing_frame_fallback`	Per-frame behavior when detection fails in a batch. `"empty"` leaves the frame faceless. `"previous"` copies the most recent successful detection. `"interpolate"` lerps landmarks/bbox/blendshapes between bracketing successful frames. Multi-face: pairs faces across frames by greedy bbox-centre NN. Default: `"empty"`.	COMBO	No	`"empty"` `"previous"` `"interpolate"`

Outputs

Output Name	Description	Data Type
`face_landmarks`	A structured output containing per-frame face detection results, including 468 facial landmarks, ARKit-52 blendshape coefficients, transformation matrices, and connection sets for mesh visualization.	FACE_LANDMARKS
`bboxes`	A list of bounding boxes for each detected face, with coordinates (x, y, width, height), label “face”, and confidence score. One list per input frame.	BOUNDING_BOX

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): f60ed6201288a59d65d62cc98c12f227a353870c36decea8da81a063cfdf2bba

​Overview

​Inputs

​Outputs

Overview

Inputs

Outputs