## Обзор

Обнаруживает лица на изображении и определяет 468 ключевых точек (ландмарков) на каждом лице с помощью моделей BlazeFace и FaceMesh от MediaPipe. Также вычисляет коэффициенты блендшейпов 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, ширина, высота), меткой "face" и оценкой уверенности. Один список на входной кадр. | BOUNDING_BOX |

> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MediaPipeFaceLandmarker/ru.md)

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