> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-mintlify-b90d3c69.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MediaPipe：ComfyUI 顔検出

> ComfyUI で MediaPipe Face Detection を使用して顔を検出し、顔のランドマーク、境界ボックス、領域マスクを抽出する方法を学びます

<Tip>
  <Tabs>
    <Tab title="ポータブル版または自宅サーバーで実行しているユーザー">
      ComfyUI が最新版に更新されていることを確認してください。

      * [ComfyUI のダウンロード](https://www.comfy.org/download)
      * [更新手順](/ja/installation/update_comfyui)

      このガイドで紹介するワークフローは、[ワークフローテンプレート](/ja/interface/features/template)から入手できます。\
      テンプレート内に該当のワークフローが見つからない場合、ComfyUI のバージョンが古くなっている可能性があります。（デスクトップ版の更新は若干遅れることがあります）

      ワークフローを読み込んだ際にノードが欠落している場合の主な原因：

      1. 最新の ComfyUI（Nightly 版）を使用していない
      2. 起動時に一部のノードのインポートに失敗している
    </Tab>

    <Tab title="デスクトップ版またはクラウド版ユーザー">
      * デスクトップ版は ComfyUI の安定版（Stable Release）をベースとしており、新しいデスクトップ安定版がリリースされると自動的に更新されます。
      * [Cloud](https://cloud.comfy.org) は、ComfyUI の安定版リリース後に更新されます。

      したがって、このドキュメントで記載されているコアノードのうち、一部が利用できない場合は、そのノード機能がまだ最新の安定版に含まれていないためです。次回の安定版リリースをお待ちください。
    </Tab>
  </Tabs>
</Tip>

[MediaPipe](https://github.com/google-ai-edge/mediapipe) は Google のオープンソース機械学習ソリューションで、リアルタイム認識を実現します。ComfyUI では、MediaPipe Face Detection が **BlazeFace** 検出、**FaceMesh v2** ランドマーク推定、**ARKit-52 blendshape** を単一の統合ワークフローで提供します。

MediaPipe Face Detection は ComfyUI にネイティブ対応しています（PR [#14009](https://github.com/Comfy-Org/ComfyUI/pull/14009)）。モデルウェイトは [Apache 2.0 License](https://github.com/google-ai-edge/mediapipe/blob/master/LICENSE) のもとで提供されています。

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

### 主な機能

* **高速顔検出** — BlazeFace ベースの検出器、近距離（約 2 m）と遠距離（約 5 m）のバリアント
* **478 の顔ランドマーク** — 検出された顔ごとの高密度 FaceMesh v2 キーポイント
* **ARKit-52 blendshape** — リアルタイムの表情係数
* **顔領域マスク** — 顔の輪郭、唇、目、虹彩の領域別マスク
* **顔境界ボックス** — `DrawBBoxes` ノードと互換性のある出力で境界ボックス可視化が可能

> **対象範囲：** 顔検出のみ — BlazeFace + FaceMesh v2 + ARKit blendshape。手、姿勢、全身検出は含まれません。

## MediaPipe Face Detection ワークフロー

### 1. ワークフローのダウンロード

ComfyUI を最新バージョンにアップデートし、`Workflow` → `Browse Templates` に移動して、Utility カテゴリから "Mediapipe: Image Face Detection" を探してください。

<Card title="ワークフローのJSONをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/utility_face_detection_mediapipe.json">
  ワークフローをダウンロード
</Card>

<Card title="Comfy Cloud で実行" icon="cloud" href="https://cloud.comfy.org/?template=utility_face_detection_mediapipe&utm_source=docs&utm_medium=referral&utm_campaign=mediapipe">
  クラウドで開く
</Card>

<Card title="サンプル画像をダウンロード" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/soft_neon_girl.png">
  このワークフローの入力サンプル画像を取得
</Card>

![MediaPipe Face Detection プレビュー](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/utility_face_detection_mediapipe-1.webp)

### 2. モデルのダウンロード

MediaPipe Face Detection モデルは [Comfy-Org MediaPipe model repository](https://huggingface.co/Comfy-Org/mediapipe) でホストされています。

* [mediapipe\_face\_fp32.safetensors](https://huggingface.co/Comfy-Org/mediapipe/resolve/main/detection/mediapipe_face_fp32.safetensors)

以下のディレクトリ構造に配置してください：

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

### 3. ワークフローの使用方法

このワークフローは **subgraph**（サブグラフ）ノードを使用して、顔検出、可視化、マスク生成を調整します。サブグラフは以下の制御パラメータを公開しています：

<Card title="Subgraph について" icon="book-open" href="/ja/interface/features/subgraph">
  このワークフローは Subgraph ノードを使用したモジュール処理を採用しています。Subgraph のドキュメントを参照して、ワークフローのカスタマイズと拡張方法を学んでください。
</Card>

**サブグラフの入力：**

| 入力                   | 説明                                                             |
| -------------------- | -------------------------------------------------------------- |
| **image**            | 解析する入力画像バッチ                                                    |
| **face\_landmarker** | オプション。空の場合は内蔵モデルローダーを使用。外部 `FACE_DETECTION_MODEL` 出力を接続して上書き可能 |

**サブグラフのパラメータ：**

| パラメータ                  |               デフォルト               | 説明                                                                                                                          |
| ---------------------- | :-------------------------------: | --------------------------------------------------------------------------------------------------------------------------- |
| **model\_name**        | `mediapipe_face_fp32.safetensors` | `ComfyUI/models/detection/` 内のチェックポイント。不足している場合は上記のモデルをダウンロード                                                               |
| **detector\_variant**  |              `short`              | **short** — 近距離/大きな顔向けに調整（約 2 m）。**full** — より小さい/遠い顔もカバー（約 5 m）、低速。**both** — 両方の検出器を実行し、フレームごとにより多くの顔を見つけた方を採用（約 2 倍のコスト） |
| **num\_faces**         |                `1`                | フレームごとに返す最大顔数。`0` = 制限なし（検出されたすべてを返す）。範囲：0–16                                                                               |
| **custom\_face\_oval** |              `false`              | マスク出力に顔の輪郭領域を含める                                                                                                            |
| **custom\_lips**       |              `false`              | マスクに唇を含める（他の有効領域と結合）                                                                                                        |
| **custom\_left\_eye**  |              `false`              | マスクに左目領域を含める                                                                                                                |
| **custom\_right\_eye** |              `false`              | マスクに右目領域を含める                                                                                                                |
| **custom\_irises**     |              `false`              | マスクに虹彩領域を含める                                                                                                                |

マスク切り替えは内部的にカスタムモードを使用します：チェックされた領域のみが塗りつぶされ、複数の ON 領域はフレームごとに 1 つのマスクに結合されます。

**サブグラフの出力：**

| 出力                  | タイプ              | 説明                                                                                   |
| ------------------- | ---------------- | ------------------------------------------------------------------------------------ |
| **face\_landmarks** | `FACE_LANDMARKS` | フレームごとの顔データ。478 の 2D/3D ランドマーク、ARKit-52 blendshape、メッシュトポロジデータを含む — 可視化ノードとマスクノードに供給 |
| **bboxes**          | `BOUNDING_BOX`   | 顔境界ボックス — `DrawBBoxes` ノードと互換                                                        |
| **mask**            | `MASK`           | 有効な領域切り替えから生成されたバイナリマスク                                                              |

### 4. ワークフローの実行

1. モデルファイルが `ComfyUI/models/detection/` に配置されていることを確認
2. `Load Image` ノードで画像を読み込み
3. 必要に応じて検出パラメータを調整
4. `Queue` をクリックするか `Ctrl(Cmd) + Enter` で実行
5. ワークフローはメッシュオーバーレイ、境界ボックス、マスクプレビューを出力

## コミュニティリソース

* [MediaPipe GitHub](https://github.com/google-ai-edge/mediapipe) — MediaPipe アップストリームフレームワーク
* [Comfy-Org/mediapipe](https://huggingface.co/Comfy-Org/mediapipe) — 公式 ComfyUI モデルウェイト
* [ComfyUI Subgraph ガイド](https://docs.comfy.org/ja/interface/features/subgraph) — サブグラフの仕組みを学ぶ