> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/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`        | 추적할 첫 번째 프레임의 마스크 (객체당 하나씩). `conditioning`이 제공되지 않은 경우 필수입니다. | MASK         | 아니요   | 객체당 하나의 마스크           |
| `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/ko.md)

***

**Source fingerprint (SHA-256):** `30768bdf5839c1d7b984675e68a127a27f21b17724a2dc885e27f00c272db3cb`