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

# SAM3_VideoTrack - ComfyUI Built-in Node Documentation

> Complete documentation for the SAM3_VideoTrack node in ComfyUI. Learn its inputs, outputs, parameters and usage.

以下が翻訳結果です。

## 概要

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

## 入力

| パラメータ                 | 説明                                                          | データ型         | 必須  | 範囲                  |
| --------------------- | ----------------------------------------------------------- | ------------ | --- | ------------------- |
| `images`              | バッチ画像としてのビデオフレーム                                            | IMAGE        | はい  | バッチ処理されたビデオフレーム     |
| `model`               | 追跡に使用するSAM3モデル                                              | MODEL        | はい  | SAM3モデル             |
| `initial_mask`        | 追跡する最初のフレームのマスク（オブジェクトごとに1つ）。`conditioning`が提供されない場合に必須です。  | MASK         | いいえ | オブジェクトごとに1つのマスク     |
| `conditioning`        | 追跡中に新しいオブジェクトを検出するためのテキスト条件付け。`initial_mask`が提供されない場合に必須です。 | CONDITIONING | いいえ | テキスト条件付け            |
| `detection_threshold` | テキストプロンプトによる検出のスコアしきい値                                      | FLOAT        | いいえ | 0.0～1.0（デフォルト: 0.5） |
| `max_objects`         | 最大追跡オブジェクト数。初期マスクはこの制限にカウントされます。0は内部上限の64を使用します。            | INT          | いいえ | 0～64（デフォルト: 0）      |
| `detect_interval`     | Nフレームごとに検出を実行します（1=毎フレーム）。値を大きくすると計算負荷が軽減されます。              | INT          | いいえ | 1～無制限（デフォルト: 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):** `30768bdf5839c1d7b984675e68a127a27f21b17724a2dc885e27f00c272db3cb`