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

# SAM3_VideoTrack - ComfyUI Built-in Node Documentation

> SAM3のメモリベースのトラッカーを使用して、ビデオフレーム間でオブジェクトを追跡します。

SAM3のメモリベースのトラッカーを使用して、ビデオフレーム間でオブジェクトを追跡します。このノードはビデオフレームのシーケンスを処理し、初期マスクまたはテキストプロンプトのいずれかを使用して追跡対象を定義し、フレーム間でオブジェクトの識別情報を維持します。

## 入力

| パラメータ                 | 説明                                                              | データ型         | 必須  | 範囲              |
| --------------------- | --------------------------------------------------------------- | ------------ | --- | --------------- |
| `images`              | バッチ処理された画像としてのビデオフレーム                                           | IMAGE        | はい  | バッチ処理されたビデオフレーム |
| `model`               | 追跡に使用するSAM3モデル                                                  | MODEL        | はい  | SAM3モデル         |
| `initial_mask`        | 追跡する最初のフレーム用のマスク（オブジェクトごとに1つ）                                   | MASK         | いいえ | オブジェクトごとに1つのマスク |
| `conditioning`        | 追跡中に新しいオブジェクトを検出するためのテキスト条件付け                                   | CONDITIONING | いいえ | テキスト条件付け        |
| `detection_threshold` | テキストプロンプトによる検出のスコアしきい値（デフォルト: 0.5）                              | FLOAT        | いいえ | 0.0〜1.0         |
| `max_objects`         | 追跡する最大オブジェクト数。初期マスクもこの上限に含まれます。0を指定すると内部上限の64が使用されます。（デフォルト: 4） | INT          | いいえ | 0〜64            |
| `detect_interval`     | Nフレームごとに検出を実行します（1=毎フレーム）。値が大きいほど計算リソースを節約できます。（デフォルト: 1）       | INT          | いいえ | 1以上             |

**注意:** `initial_mask` または `conditioning` のいずれかを指定する必要があります。両方とも省略した場合、ノードはエラーを発生させます。

## 出力

| 出力名          | 説明                                     | データ型          |
| ------------ | -------------------------------------- | ------------- |
| `track_data` | すべてのビデオフレームにわたるオブジェクトマスクとメタデータを含む追跡データ | SAM3TrackData |

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

***

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