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

# MediaPipeFaceLandmarker - ComfyUI Built-in Node Documentation

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

以下が翻訳結果です。

## 概要

画像内の顔を検出し、MediaPipeのBlazeFaceおよびFaceMeshモデルを使用して、各顔の468個の顔のランドマーク（キーポイント）を特定します。また、表情分析のためのARKit-52ブレンドシェイプ係数も計算します。このノードはバッチ内の複数の画像を処理でき、検出された各顔のランドマークデータとバウンディングボックスの両方を出力します。

## 入力

| パラメータ                    | 説明                                                                                                                                                                                                                  | データ型                   | 必須  | 範囲                                               |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | --- | ------------------------------------------------ |
| `face_detection_model`   | ランドマーク検出に使用するMediaPipe顔検出モデルです。                                                                                                                                                                                     | FACE\_DETECTION\_MODEL | はい  |                                                  |
| `image`                  | 顔を検出する入力画像または画像のバッチです。                                                                                                                                                                                              | IMAGE                  | はい  |                                                  |
| `detector_variant`       | 顔検出器の範囲です。`"short"`は近距離の顔（カメラから約2m以内）に最適化されています。`"full"`はより遠く/小さい顔（最大約5m）をカバーしますが、処理は遅くなります。`"both"`は両方の検出器を実行し、フレームごとにより多くの顔が見つかった方を採用します（検出コストは約2倍）。デフォルト: `"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」、信頼度スコアが含まれます。入力フレームごとに1つのリストが出力されます。 | BOUNDING\_BOX   |

> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください！ [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MediaPipeFaceLandmarker/ja.md)

***

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