ComfyPilotComfyPilot
文档 / 节点说明 / SAM3 视频跟踪

SAM3 视频跟踪

使用 SAM3 基于记忆的跟踪器跨视频帧跟踪对象。此节点处理一系列视频帧,并在各帧之间保持对象身份;您可以使用初始掩码或文本提示来指定要跟踪的对象,还可以通过文本条件在跟踪过程中检测新对象。

节点说明 SAM3_VideoTrack 更新于 2026-11-12

查看官方原文

SAM3 视频跟踪 - ComfyUI Built-in Node Documentation

使用 SAM3 基于记忆的跟踪器跨视频帧跟踪对象。此节点处理一系列视频帧,并在各帧之间保持对象身份;您可以使用初始掩码或文本提示来指定要跟踪的对象,还可以通过文本条件在跟踪过程中检测新对象。

使用 SAM3 基于记忆的跟踪器跨视频帧跟踪对象。此节点处理一系列视频帧,并在各帧之间保持对象身份;您可以使用初始掩码或文本提示来指定要跟踪的对象,还可以通过文本条件在跟踪过程中检测新对象。

输入

参数描述数据类型必填范围
图像视频帧,以批量图像形式提供IMAGE是批量视频帧
model用于跟踪的 SAM3 模型MODEL是SAM3 模型
初始 mask用于第一帧跟踪的掩码(每个对象一个掩码)MASK否每个对象一个掩码
条件用于在跟踪过程中检测新对象的文本条件CONDITIONING否文本条件
检测阈值文本提示检测的分数阈值(默认值:0.5)FLOAT否0.0 到 1.0 (步长:0.01)
最大对象数最大跟踪对象数。初始掩码也计入此上限。0 表示使用内部上限 64。(默认值:4)INT否0 到 64
检测间隔每隔 N 帧运行一次检测(1 表示每帧都检测)。值越大越节省算力。(默认值:1)INT否1 或更高

注意: 必须提供 initial_mask 或 conditioning 中的至少一个。如果两者都省略,节点会报错。

输出

输出名称描述数据类型
track_data跟踪数据,包含所有视频帧中的对象掩码和元数据SAM3\_TRACK\_DATA
本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! 在 GitHub 上编辑

Source fingerprint (SHA-256): ef584628b334997a001a857a7deffb7eda34db8fa50e3d734a07b5e92566d48d