MediaPipe: detección de rostros en ComfyUI

Usuarios locales
Usuarios de Cloud

Asegúrate de que tu ComfyUI esté actualizado.

Los flujos de trabajo de esta guía se encuentran en las Plantillas de flujos de trabajo. Si no los encuentras en las plantillas, es posible que tu ComfyUI esté desactualizado.Si faltan nodos al cargar un flujo de trabajo, estas son las posibles razones:

No estás usando la última versión de ComfyUI (versión nocturna)
Algunos nodos fallaron al importarse durante el inicio

MediaPipe es la solución de aprendizaje automático de código abierto de Google para la percepción en tiempo real. En ComfyUI, MediaPipe Face Detection ofrece detección BlazeFace, estimación de puntos faciales con FaceMesh v2 y blendshapes ARKit-52, todo en un único flujo de trabajo unificado. MediaPipe Face Detection es compatible de forma nativa con ComfyUI (PR #14009), y los pesos del modelo están disponibles bajo la Licencia Apache 2.0. MediaPipe GitHub | Repositorio de modelos de Comfy-Org

Capacidades clave

Detección facial rápida: detector basado en BlazeFace con variantes de alcance corto (~2 m) y completo (~5 m)
478 puntos faciales: puntos clave densos de FaceMesh v2 por cada rostro detectado
Blendshapes ARKit-52: coeficientes de expresión facial en tiempo real
Máscaras de regiones faciales: máscaras por región para el óvalo facial, los labios, los ojos y los iris
Cajas delimitadoras faciales: salidas compatibles con DrawBBoxes para la visualización de cajas delimitadoras

Rango: solo detección facial: BlazeFace + FaceMesh v2 + blendshapes ARKit. No cubre detección de manos, pose ni holística.

Flujo de trabajo de detección de caras con MediaPipe

Detección de caras en imágenes con Mediapipe

Sube una imagen y detecta hasta 6 puntos faciales por cara, lo que permite una detección ultrarrápida de varias caras. Vista previa del flujo de trabajo de detección de caras en imágenes con Mediapipe

Ejecutar en Comfy Cloud

Abrir en Comfy Cloud

Descargar flujo de trabajo

Descarga el JSON o busca “Mediapipe: Image Face Detection” en la Biblioteca de plantillas

Materiales de entrada Sube este archivo al nodo LoadImage correspondiente:

soft_neon_girl.png

Nodo LoadImage 5 · soft_neon_girl.png

1. Descargar el flujo de trabajo

Actualiza tu ComfyUI a la última versión y luego ve a Workflow → Browse Templates y busca “Mediapipe: Image Face Detection” en la categoría Utility.

2. Descargar el modelo

El modelo MediaPipe Face Detection está alojado en el repositorio de modelos MediaPipe de Comfy-Org.

mediapipe_face_fp32.safetensors

Colócalo en la siguiente estructura de directorios:

📂 ComfyUI/
└── 📂 models/
    └── 📂 detection/
        └── mediapipe_face_fp32.safetensors

3. Usar el flujo de trabajo

Este flujo de trabajo usa un nodo de subgrafo que organiza la detección de caras, la visualización y la generación de máscaras. El subgrafo expone los siguientes controles:

Acerca del subgrafo

Este flujo de trabajo usa nodos de subgrafo para un procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y ampliar el flujo de trabajo.

Entradas del subgrafo:

Entrada	Descripción
image	Lote de imágenes de entrada que se va a analizar
face_landmarker	Opcional. Déjalo vacío para usar el cargador de modelos integrado. Conecta una salida externa `FACE_DETECTION_MODEL` para reemplazarlo

Parámetros del subgrafo:

Parámetro	Predeterminado	Descripción
model_name	`mediapipe_face_fp32.safetensors`	Checkpoint en `ComfyUI/models/detection/`. Si falta, descarga el modelo de arriba
detector_variant	`short`	short: ajustado para caras cercanas/grandes (~2 m de alcance). full: cubre caras más pequeñas/lejanas (~5 m), más lento. both: ejecuta ambos detectores y conserva el que encontró más caras por fotograma (~2× de costo)
num_faces	`1`	Máximo de caras que se devuelven por fotograma. `0` = sin límite (devuelve todas las detectadas). Rango: 0–16
custom_face_oval	`false`	Incluye la región del contorno de la cara en la máscara de salida
custom_lips	`false`	Incluye los labios en la máscara (unión con las demás regiones habilitadas)
custom_left_eye	`false`	Incluye la región del ojo izquierdo en la máscara
custom_right_eye	`false`	Incluye la región del ojo derecho en la máscara
custom_irises	`false`	Incluye las regiones de los iris en la máscara

Las opciones de máscara usan el modo custom de forma interna: solo se rellenan las regiones marcadas; varias regiones activadas se unen en una sola máscara por fotograma. Salidas del subgrafo:

Salida	Tipo	Descripción
face_landmarks	`FACE_LANDMARKS`	Caras por fotograma con 478 puntos 2D/3D, blendshapes ARKit-52 y datos de topología de malla. Alimenta los nodos de visualización y de máscara
bboxes	`BOUNDING_BOX`	Cuadros delimitadores de caras: compatible con el nodo `DrawBBoxes`
mask	`MASK`	Máscara binaria generada a partir de las opciones de región habilitadas

4. Ejecutar el flujo de trabajo

Asegúrate de que el archivo del modelo esté en ComfyUI/models/detection/
Carga una imagen en el nodo Load Image
Ajusta los parámetros de detección según sea necesario
Haz clic en Queue o usa Ctrl(Cmd) + Enter para ejecutar
El flujo de trabajo genera la superposición de la malla, los cuadros delimitadores y la vista previa de la máscara

Recursos de la comunidad

MediaPipe GitHub: framework MediaPipe original
Comfy-Org/mediapipe: pesos de modelo oficiales de ComfyUI
Guía de subgrafos de ComfyUI: aprende cómo funcionan los subgrafos

Conceptos básicos

Guía de la interfaz

Tutoriales

Nodos de Comfy Cloud

Nodos asociados

MediaPipe: detección de rostros en ComfyUI

Capacidades clave

Flujo de trabajo de detección de caras con MediaPipe

Detección de caras en imágenes con Mediapipe

Ejecutar en Comfy Cloud

Descargar flujo de trabajo

soft_neon_girl.png

1. Descargar el flujo de trabajo

2. Descargar el modelo

3. Usar el flujo de trabajo

Acerca del subgrafo

4. Ejecutar el flujo de trabajo

Recursos de la comunidad

​Capacidades clave

​Flujo de trabajo de detección de caras con MediaPipe

​Detección de caras en imágenes con Mediapipe

Ejecutar en Comfy Cloud

Descargar flujo de trabajo

soft_neon_girl.png

​1. Descargar el flujo de trabajo

​2. Descargar el modelo

​3. Usar el flujo de trabajo

Acerca del subgrafo

​4. Ejecutar el flujo de trabajo

​Recursos de la comunidad

Capacidades clave

Flujo de trabajo de detección de caras con MediaPipe

Detección de caras en imágenes con Mediapipe

1. Descargar el flujo de trabajo

2. Descargar el modelo

3. Usar el flujo de trabajo

4. Ejecutar el flujo de trabajo

Recursos de la comunidad