MediaPipeFaceMask - ComfyUI Built-in Node Documentation

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

​

## 概述

此节点基于 MediaPipe 检测到的面部特征点创建二值掩码（黑白图像）。它会为每个检测到的面部区域绘制填充多边形，在批次中为每一帧生成一个掩码。当同一帧中检测到多张人脸时，这些掩码会被合并为单个掩码。

​

## 输入

参数	描述	数据类型	是否必需	取值范围
face_landmarks	来自 MediaPipe 面部检测节点的面部特征点数据。	FACE_LANDMARKS	是	-
regions	选择要包含在掩码中的面部区域。"all" 会从所有面部区域（面部轮廓、嘴唇、眼睛、虹膜）的并集创建掩码。"custom" 允许您单独切换每个区域。默认值："all"	COMBO	是	"all" "custom"

当 regions 设置为 "custom" 时，以下额外的布尔参数将变为可用：

参数	描述	数据类型	是否必需	取值范围
face_oval	在掩码中包含面部轮廓区域。默认值：True	BOOLEAN	否	True/False
lips	在掩码中包含嘴唇区域。默认值：True	BOOLEAN	否	True/False
eyes	在掩码中包含眼睛区域。默认值：True	BOOLEAN	否	True/False
irises	在掩码中包含虹膜区域。默认值：True	BOOLEAN	否	True/False

注意： 使用 "all" 模式时，掩码包含所有区域的组合。由于面部轮廓区域包含其他区域，选择 "all" 实际上会产生与仅选择面部轮廓相同的结果。

​

## 输出

输出名称	描述	数据类型
MASK	一个二值掩码张量，其中面部区域为白色（值 1.0），背景为黑色（值 0.0）。该掩码具有与输入图像相同的尺寸，并且批次中每一帧对应一个掩码。	MASK

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

---

Source fingerprint (SHA-256): 92270002a42ed59bc75e676a6881e1899186d3c8a1bb4dd4c0d39b3762b5bb66