SAM3_VideoTrack - ComfyUI Built-in Node Documentation

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

Source fingerprint (SHA-256): ef584628b334997a001a857a7deffb7eda34db8fa50e3d734a07b5e92566d48d