> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.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（0.01刻み） |
| `max_objects`         | 追跡するオブジェクトの最大数。初期マスクもこの上限に含まれます。0の場合は内部上限の64を使用します。（デフォルト: 4） | INT          | いいえ | 0～64            |
| `detect_interval`     | Nフレームごとに検出を実行します（1=毎フレーム）。値を大きくすると計算量を節約できます。（デフォルト: 1）       | INT          | いいえ | 1以上             |

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

## 出力

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

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

***

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