> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.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`        | 추적할 첫 번째 프레임의 마스크(객체당 하나)                                      | MASK         | 아니요 | 객체당 마스크 하나  |
| `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/ko.md)

***

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