SAM3_VideoTrack - ComfyUI Built-in Node Documentation

使用 SAM3 的基于记忆的跟踪器跨视频帧跟踪对象。此节点处理一系列视频帧，并在帧之间保持对象身份，使用初始掩码或文本提示来定义要跟踪的内容。

输入

参数	描述	数据类型	是否必需	范围
`图像`	作为批处理图像的视频帧	IMAGE	是	Batched video frames
`model`	用于跟踪的 SAM3 模型	MODEL	是	SAM3 model
`初始 mask`	用于跟踪第一帧的掩码（每个对象一个）	MASK	否	One mask per object
`条件`	用于在跟踪过程中检测新对象的文本条件	CONDITIONING	否	Text conditioning
`检测阈值`	文本提示检测的分数阈值（默认值：0.5）	FLOAT	否	0.0 到 1.0
`最大对象数`	最大跟踪对象数。初始掩码计入此限制。0 使用内部上限 64。（默认值：4）	INT	否	0 到 64
`检测间隔`	每 N 帧运行一次检测（1=每帧）。较高的值可节省计算量。（默认值：1）	INT	否	1 or higher

注意： 必须提供 initial_mask 或 conditioning 中的至少一个。如果两者都省略，节点将引发错误。

输出名称	描述	数据类型
`跟踪数据`	包含所有视频帧中对象掩码和元数据的跟踪数据	SAM3TrackData

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！在 GitHub 上编辑

Source fingerprint (SHA-256): ef584628b334997a001a857a7deffb7eda34db8fa50e3d734a07b5e92566d48d