> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# MediaPipeFaceLandmarker - ComfyUI Built-in Node Documentation

> Complete documentation for the MediaPipeFaceLandmarker node in ComfyUI. Learn its inputs, outputs, parameters and usage.

## 概述

使用 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"`<br />`"full"`<br />`"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"`<br />`"previous"`<br />`"interpolate"` |

## 输出

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

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MediaPipeFaceLandmarker/zh.md)

***

**Source fingerprint (SHA-256):** `f60ed6201288a59d65d62cc98c12f227a353870c36decea8da81a063cfdf2bba`