> ## 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.

# MediaPipe: detección de rostros en ComfyUI

> Aprende a usar MediaPipe Face Detection en ComfyUI para detectar rostros y extraer puntos faciales, cuadros delimitadores y máscaras de región

> [!TIP]
>
> **Usuarios locales**
>
> Asegúrate de que tu ComfyUI esté actualizado.
>
> * [Descargar ComfyUI](https://www.comfy.org/download)
> * [Guía de actualización](https://docs.comfy.org/es/installation/update_comfyui.md)
>
> Los flujos de trabajo de esta guía se encuentran en las [Plantillas de flujos de trabajo](https://docs.comfy.org/es/interface/features/template.md).
> 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:
>
> 1. No estás usando la última versión de ComfyUI (versión nocturna)
> 2. Algunos nodos fallaron al importarse durante el inicio
>
> **Usuarios de Cloud**
>
> * [Cloud](https://cloud.comfy.org) se actualizará después del lanzamiento estable de ComfyUI.
>
> Por lo tanto, si notas que falta algún nodo central en este documento, puede deberse a que los nuevos nodos centrales aún no se han publicado en la última versión estable. Espera al próximo lanzamiento estable.

[MediaPipe](https://github.com/google-ai-edge/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](https://github.com/Comfy-Org/ComfyUI/pull/14009)), y los pesos del modelo están disponibles bajo la [Licencia Apache 2.0](https://github.com/google-ai-edge/mediapipe/blob/master/LICENSE).

[MediaPipe GitHub](https://github.com/google-ai-edge/mediapipe) | [Repositorio de modelos de Comfy-Org](https://huggingface.co/Comfy-Org/mediapipe)

### 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](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/utility_face_detection_mediapipe-1.webp)

> **[Ejecutar en Comfy Cloud](https://cloud.comfy.org/?template=utility_face_detection_mediapipe\&utm_source=docs\&utm_medium=referral\&utm_campaign=mediapipe)**
>
> Abrir en Comfy Cloud

> **[Descargar flujo de trabajo](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/utility_face_detection_mediapipe.json)**
>
> 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](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/soft_neon_girl.png)**
>
> Nodo `LoadImage` 5 · `soft_neon_girl.png`

![Imagen de entrada](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/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](https://huggingface.co/Comfy-Org/mediapipe).

* [mediapipe\_face\_fp32.safetensors](https://huggingface.co/Comfy-Org/mediapipe/blob/main/detection/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](https://docs.comfy.org/es/interface/features/subgraph.md)**
>
> 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

1. Asegúrate de que el archivo del modelo esté en `ComfyUI/models/detection/`
2. Carga una imagen en el nodo `Load Image`
3. Ajusta los parámetros de detección según sea necesario
4. Haz clic en `Queue` o usa `Ctrl(Cmd) + Enter` para ejecutar
5. 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](https://github.com/google-ai-edge/mediapipe): framework MediaPipe original
* [Comfy-Org/mediapipe](https://huggingface.co/Comfy-Org/mediapipe): pesos de modelo oficiales de ComfyUI
* [Guía de subgrafos de ComfyUI](https://docs.comfy.org/interface/features/subgraph.md): aprende cómo funcionan los subgrafos


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.