> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-wan3-30off-promo.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="クラウドユーザー">
      * [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 ワークフロー

<h3 id="utility_face_detection_mediapipe">
  Mediapipe: Image Face Detection
</h3>

画像を入力すると、顔ごとに最大 6 つのフェイシャルランドマークを検出し、超高速の複数顔検出を可能にします。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/utility_face_detection_mediapipe-1.webp" alt="Mediapipe 画像顔検出ワークフローのプレビュー" />

<CardGroup cols={2}>
  <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">
    Comfy Cloud で開く
  </Card>

  <Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/utility_face_detection_mediapipe.json">
    JSONをダウンロードするか、テンプレートライブラリで "Mediapipe: Image Face Detection" を検索してください
  </Card>
</CardGroup>

**入力素材**

このファイルを対応する `LoadImage` ノードにアップロードしてください：

<CardGroup cols={2}>
  <Card title="soft_neon_girl.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/soft_neon_girl.png">
    `LoadImage` ノード 5 · `soft_neon_girl.png`
  </Card>
</CardGroup>

<div style={{display: 'grid', gridTemplateColumns: 'repeat(2, minmax(0, 1fr))', gap: '1rem', alignItems: 'start'}}>
  <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/soft_neon_girl.png" alt="入力画像" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />
</div>

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

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

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

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

* [mediapipe\_face\_fp32.safetensors](https://huggingface.co/Comfy-Org/mediapipe/blob/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 ブレンドシェイプ、メッシュトポロジデータを含み、可視化ノードとマスクノードに供給されます |
| **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) — サブグラフの仕組みを学ぶ