> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec-462120c.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SAM 3.1：ComfyUI 汎用セグメンテーションワークフロー

> Meta の SAM 3.1 モデルを使って、ComfyUI でテキストプロンプトによる画像・動画のセグメンテーションを行う方法を学びます

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

[SAM 3](https://ai.meta.com/sam3)（Segment Anything Model 3）は、Meta が開発した画像・動画向けの統一ファンデーションモデルで、テキストや視覚的プロンプト（ポイント、ボックス、マスク）を用いた検出、セグメンテーション、オブジェクトトラッキングを実現します。前世代の [SAM 2](https://github.com/facebookresearch/sam2) と比較して、短いテキストフレーズで指定したオープンボキャブラリー概念の全インスタンスを網羅的にセグメントできる点が特徴です。

[SAM 3.1 Multiplex](https://github.com/facebookresearch/sam3) は最新のチェックポイントリリースで、共有メモリ方式によるマルチオブジェクトトラッキングを導入し、精度を維持しながら大幅な高速化を実現しました。

SAM 3.1 は ComfyUI でネイティブサポートされており（PR [#13408](https://github.com/Comfy-Org/ComfyUI/pull/13408)）、モデルウェイトは [SAM License](https://github.com/facebookresearch/sam3/blob/main/LICENSE) のもとで提供されています。

[SAM 3 GitHub](https://github.com/facebookresearch/sam3) | [論文 (arXiv)](https://arxiv.org/abs/2604.02296) | [🤗 Model Hub](https://huggingface.co/Comfy-Org/sam3.1)

<video controls width="100%">
  <source src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/utility_video_segment_sam3.mp4" type="video/mp4" />
</video>

SAM 3.1 はテキストプロンプトに基づいて動画フレーム全体でオブジェクトをセグメントおよびトラッキングします。上の例は、対象オブジェクトにマスクを適用したセグメンテーション出力を示しています。

### 主な強み

* **テキスト駆動のセグメンテーション** — 自然言語でセグメント対象を指定。手動でのポイント/ボックス注釈は不要
* **画像・動画両対応** — 単一画像のセグメンテーションから動画シーケンスのフレーム間トラッキングまで
* **マルチオブジェクト対応** — カンマ区切りのプロンプトで複数オブジェクトを同時にセグメント・トラッキング
* **オープンボキャブラリー** — 従来手法よりもはるかに広範なオープンボキャブラリー概念を処理

> **制限事項：** テキストプロンプトのトークン上限は 32 トークンです。最良の結果を得るには、プロンプトを短く具体的に保ってください。

## SAM 3.1 セグメンテーションワークフロー

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

ComfyUI を最新バージョンにアップデートし、`ワークフロー` -> `テンプレートをブラウズ` に進み、Utility カテゴリから SAM 3.1 ワークフローを見つけてください。

<h3 id="utility_video_segment_sam3">
  SAM3: 動画セグメンテーション
</h3>

SAM3 モデルを使用して、動画から主要な被写体やコンテンツをセグメントし、特定のオブジェクトや領域を分離します。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/utility_video_segment_sam3-1.webp" alt="SAM3 動画セグメンテーションワークフローのプレビュー" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud で実行" icon="cloud" href="https://cloud.comfy.org/?template=utility_video_segment_sam3&utm_source=docs&utm_medium=referral&utm_campaign=video-segment-sam3">
    Comfy Cloud で開く
  </Card>

  <Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/utility_video_segment_sam3.json">
    JSON をダウンロードするか、テンプレートライブラリーで「SAM3: 動画セグメンテーション」を検索してください。
  </Card>
</CardGroup>

**入力素材**

このファイルを該当する `LoadVideo` ノードにアップロードします：

<CardGroup cols={2}>
  <Card title="drinking_unicorn.mp4" icon="download" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/drinking_unicorn.mp4">
    `LoadVideo` ノード 115 · `drinking_unicorn.mp4`
  </Card>
</CardGroup>

**出力例**

<video controls width="100%">
  <source src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/utility_video_segment_sam3.mp4" type="video/mp4" />
</video>

<h3 id="utility_image_segment_sam3">
  SAM3: 画像セグメンテーション
</h3>

SAM3 モデルを使用して、写真や画像から主要な被写体やコンテンツをセグメントし、特定のオブジェクトや領域を分離します。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/utility_image_segment_sam3-1.webp" alt="SAM3 画像セグメンテーションワークフローのプレビュー" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud で実行" icon="cloud" href="https://cloud.comfy.org/?template=utility_image_segment_sam3&utm_source=docs&utm_medium=referral&utm_campaign=video-segment-sam3">
    Comfy Cloud で開く
  </Card>

  <Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/utility_image_segment_sam3.json">
    JSON をダウンロードするか、テンプレートライブラリーで「SAM3: 画像セグメンテーション」を検索してください。
  </Card>
</CardGroup>

**入力素材**

このファイルを該当する `LoadImage` ノードにアップロードします：

<CardGroup cols={2}>
  <Card title="neon_guitarist.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/neon_guitarist.png">
    `LoadImage` ノード 79 · `neon_guitarist.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/neon_guitarist.png" alt="入力画像" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />
</div>

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

SAM 3.1 モデルは [Comfy-Org SAM 3.1 モデルリポジトリ](https://huggingface.co/Comfy-Org/sam3.1) でホストされています。

* [sam3.1\_multiplex\_fp16.safetensors](https://huggingface.co/Comfy-Org/sam3.1/blob/main/checkpoints/sam3.1_multiplex_fp16.safetensors)

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

```
📂 ComfyUI/
└── 📂 models/
    └── 📂 checkpoints/
        └── sam3.1_multiplex_fp16.safetensors
```

### 3. ワークフローの使い方

**画像セグメンテーション：**

* **画像** — `Load Image` ノードで画像を読み込みます（ComfyUI の `input/` フォルダに配置してください）
* **オブジェクトプロンプト** — セグメントするオブジェクトの短いテキスト説明（例：`person`、`car`、`cat`）
* 出力は画像に適用されたマスクで、RGBA プレビューでセグメンテーション結果を確認できます

**動画セグメンテーション：**

* **動画** — `Load Video` ノードで動画を読み込みます
* **オブジェクトプロンプト** — 画像と同じく、フレーム間で追跡・セグメントする対象の短いテキストプロンプト
* 出力には各フレームのマスクとバウンディングボックスが含まれます

**プロンプト形式：**

| プロンプト            | 役割                            |
| ---------------- | ----------------------------- |
| SAM3 オブジェクトプロンプト | セグメントする**対象**の短い説明。最大 32 トークン |

複数の対象を個別にプロンプトするには、カンマで区切り、`:N` で各プロンプトの最大検出数を指定します：
`eye:2, window panels:4`

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

## 補足説明

* **プロンプトは短く具体的に** — モデルにはプロンプトあたり 32 トークンの制限があります
* **マルチオブジェクト検出** — カンマで異なるオブジェクトタイプを区切り、`:N` でタイプごとの検出数を制限
* **セグメンテーションマスク** — 出力マスクは他のワークフロー（修復、背景除去など）の入力として使用可能
* **更新が必要** — SAM 3.1 を利用するには ComfyUI を最新バージョンにアップデートしてください