Este fluxo do ComfyUI realiza mascaramento automático de objetos em vídeo a partir de uma frase de texto simples usando o nó SAM3 Video Masking (ID: 9cea40bb-b0cf-4b40-a758-8935cfe8d52f). Você carrega um clipe com VHS_LoadVideo, descreve o que deseja isolar (por exemplo, "carro vermelho" ou "pessoa") no campo mask_prompt do nó, e o sistema encontra todas as instâncias correspondentes, rastreia ao longo dos quadros com IDs estáveis e produz três saídas: um preview de overlay da máscara, uma máscara binária por quadro e um recorte do sujeito. Os nós SaveVideo exportam os resultados.
Tecnicamente, o VHS_LoadVideo fornece uma sequência de quadros consistente (fps, resolução) para inferência. Durante a iteração, você pode limitar os quadros usando frame_load_cap para previews rápidos e depois definir como 0 para o processamento completo. O nó SAM3 Video Masking interpreta seu prompt de texto, segmenta o alvo ao longo dos quadros e mantém a continuidade de identidade para evitar flicker ou troca de objetos. As saídas são adequadas para composição, desfoque seletivo, color grading ou substituição de fundo. Um nó MarkdownNote no grafo fornece dicas e lembretes enquanto você trabalha.
API
Use este workflow a partir do código
Todo workflow Comfy é um grafo JSON. O payload abaixo é este workflow, exatamente como o ComfyUI executa — obtenha-o pela URL, mantenha-o no controle de versão ou carregue-o no ComfyUI e execute nó por nó.
Execute a partir de TypeScript ou Python com o Comfy SDK. O mesmo código serve para o Comfy Cloud ou um ComfyUI hospedado por você — apenas a URL base muda.
// 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");O SDK utiliza um workflow no formato API: abra este workflow no ComfyUI e use Arquivo → Exportar Workflow (API).
O acesso à API do Comfy Cloud requer um plano com chave de API.
FAQ
