如何导出每个输出（overlay、mask、cut-out）？

将每个 SAM3 输出分别连接到一个 SaveVideo 节点。使用 VHS_LoadVideo 的 fps 输出驱动 SaveVideo 的 fps 输入（或手动设置），选择文件路径与格式并渲染即可。你可以独立导出任意一路或全部输出流。

可以同时遮罩多个对象吗？

可以。如果提示词匹配多个实例（例如“person”），节点会对每个实例进行分割并跟踪，且 ID 稳定。要限制结果，请把提示词写得更具体（例如“person in red jacket”），或裁剪输入到感兴趣区域。

为什么在快速运动时遮罩会闪烁或漏帧？

快速运动、运动模糊或严重遮挡会降低单帧置信度并影响跟踪。可通过更具体的提示词、提高节点的 confidence/score 阈值，以及在 VRAM 允许时处理原始分辨率视频（或减少下采样）来改善效果。

需要什么硬件才能有合理速度？

强烈建议使用 GPU。性能取决于 VRAM 和算力。硬件受限时也可先降低分辨率，并用 VHS_LoadVideo 的 frame_load_cap 预览短片段，再跑完整视频。

SAM3 - 通过文本提示词进行视频遮罩

这个工作流演示了使用 SAM3 Video Masking 节点（ID: 9cea40bb-b0cf-4b40-a758-8935cfe8d52f）进行基于文本的视频遮罩。你用 VHS_LoadVideo 加载一段视频，用自然语言描述目标（例如“red car”“person”“coffee cup”），节点会找到所有匹配实例，并在各帧间跟踪它们，保持稳定的 ID。它会输出三路并行结果：预览叠加层（在原始帧上绘制彩色遮罩）、原始的二值/灰度遮罩流、以及只保留被遮罩像素的抠图流。

从技术上看，该节点会对每一帧执行文本条件的目标检测与分割，然后在时间维度上把检测结果关联起来以保持 ID 稳定。VHS_LoadVideo 提供帧序列与 fps；SaveVideo 将每一路输出流写入磁盘。为了快速迭代，你可以用 VHS_LoadVideo 的 frame_load_cap 参数限制处理帧数；完整运行时将其设回 0。画面中的 MarkdownNote 节点提供了提示词撰写与测试的内联提醒。

API

通过代码使用此工作流

每个 Comfy 工作流都是一个 JSON 图。下面的内容就是此工作流的完整数据，ComfyUI 运行时也是如此——你可以从该 URL 获取、放入版本控制，或在 ComfyUI 中加载并逐节点运行。

0a6672ca248d.json

正在获取工作流 JSON…

使用 Comfy SDK 从 TypeScript 或 Python 运行。相同代码可用于 Comfy Cloud 或你自托管的 ComfyUI——只需更改基础 URL。

// Install (beta)
npm i @comfyorg/sdk

// Run this workflow (TypeScript)
import { Comfy } from "@comfyorg/sdk";

const client = new Comfy({ apiKey: "comfyui-..." });
const wf = await client.workflows.fromFile("workflow_api.json");
const job = await client.run(wf);
await job.getOutputs("<output-node-id>")[0].toFile("output.png");

SDK 需要 API 格式的工作流：在 ComfyUI 中打开此工作流，使用文件 → 导出工作流（API）。

Comfy Cloud API 访问需要包含 API 密钥的套餐。

SDK 文档获取 API 密钥

常见问题