SAM3_VideoTrack - ComfyUI Built-in Node Documentation

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에서 편집

Source fingerprint (SHA-256): 30768bdf5839c1d7b984675e68a127a27f21b17724a2dc885e27f00c272db3cb