MediaPipeFaceLandmarker - ComfyUI Built-in Node Documentation

概述

使用 MediaPipe 的 BlazeFace 和 FaceMesh 模型检测图像中的人脸，并识别每张人脸上的 468 个面部特征点（关键点）。该节点还计算用于面部表情分析的 ARKit-52 混合变形系数。节点可批量处理多张图像，并输出每张检测到的人脸的特征点数据和边界框。

参数	描述	数据类型	必填	范围
`face_detection_model`	用于特征点检测的 MediaPipe 人脸检测模型。	FACE_DETECTION_MODEL	是
`image`	用于检测人脸的输入图像或图像批次。	IMAGE	是
`detector_variant`	人脸检测器范围。`"short"` 针对近距离人脸（距相机约 2 米以内）进行了优化；`"full"` 覆盖更远/更小的人脸（最远约 5 米），但速度较慢。`"both"` 同时运行两种检测器，并保留每帧检测到人脸数量更多的结果（检测成本约增加一倍）。默认值：`"short"`。	COMBO	是	`"short"` `"full"` `"both"`
`num_faces`	每帧返回的最大人脸数量。0 表示无上限（返回所有检测到的人脸）。默认值：1。	INT	是	0 到 16
`min_confidence`	BlazeFace 评分阈值。较低的值有助于捕捉较小或被遮挡的人脸。默认值：0.5。	FLOAT	否	0.00 到 1.00
`missing_frame_fallback`	批次中检测失败时的逐帧处理行为。`"empty"` 使该帧无人脸数据。`"previous"` 复制最近一次成功的检测结果。`"interpolate"` 在相邻成功帧之间对特征点/边界框/混合变形进行线性插值。多人脸：通过贪心边界框中心最近邻算法跨帧配对。默认值：`"empty"`。	COMBO	否	`"empty"` `"previous"` `"interpolate"`

输出名称	描述	数据类型
`bboxes`	包含每帧人脸检测结果的结构化输出，包括 468 个面部特征点、ARKit-52 混合变形系数、变换矩阵以及用于网格可视化的连接集。	FACE_LANDMARKS
`bboxes`	每张检测到的人脸的边界框列表，包含坐标 (x, y, width, height)、标签 “face” 和置信度分数。每个输入帧对应一个列表。	BOUNDING_BOX

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！在 GitHub 上编辑

Source fingerprint (SHA-256): f60ed6201288a59d65d62cc98c12f227a353870c36decea8da81a063cfdf2bba