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.
本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑
概述
使用 MediaPipe 的 BlazeFace 和 FaceMesh 模型检测图像中的人脸，并识别每张人脸上的 468 个面部特征点（关键点）。该节点还计算用于面部表情分析的 ARKit-52 混合变形系数。节点可批量处理多张图像，并输出每张检测到的人脸的特征点数据和边界框。输入
| 参数 | 数据类型 | 必填 | 范围 | 描述 |
|---|---|---|---|---|
face_detection_model | FACE_DETECTION_MODEL | 是 | 用于特征点检测的 MediaPipe 人脸检测模型。 | |
image | IMAGE | 是 | 用于检测人脸的输入图像或图像批次。 | |
detector_variant | COMBO | 是 | "short""full""both" | 人脸检测器范围。"short" 针对近距离人脸（距相机约 2 米以内）进行了优化；"full" 覆盖更远/更小的人脸（最远约 5 米），但速度较慢。"both" 同时运行两种检测器，并保留每帧检测到人脸数量更多的结果（检测成本约增加一倍）。默认值："short"。 |
num_faces | INT | 是 | 0 到 16 | 每帧返回的最大人脸数量。0 表示无上限（返回所有检测到的人脸）。默认值：1。 |
min_confidence | FLOAT | 否 | 0.00 到 1.00 | BlazeFace 评分阈值。较低的值有助于捕捉较小或被遮挡的人脸。默认值：0.5。 |
missing_frame_fallback | COMBO | 否 | "empty""previous""interpolate" | 批次中检测失败时的逐帧处理行为。"empty" 使该帧无人脸数据。"previous" 复制最近一次成功的检测结果。"interpolate" 在相邻成功帧之间对特征点/边界框/混合变形进行线性插值。多人脸：通过贪心边界框中心最近邻算法跨帧配对。默认值："empty"。 |
输出
| 输出名称 | 数据类型 | 描述 |
|---|---|---|
bboxes | FACE_LANDMARKS | 包含每帧人脸检测结果的结构化输出，包括 468 个面部特征点、ARKit-52 混合变形系数、变换矩阵以及用于网格可视化的连接集。 |
bboxes | BOUNDING_BOX | 每张检测到的人脸的边界框列表，包含坐标 (x, y, width, height)、标签 “face” 和置信度分数。每个输入帧对应一个列表。 |
Source fingerprint (SHA-256):
f60ed6201288a59d65d62cc98c12f227a353870c36decea8da81a063cfdf2bba