Este fluxo demonstra a máscara de vídeo guiada por texto com o nó SAM3 Video Masking (ID: 9cea40bb-b0cf-4b40-a758-8935cfe8d52f). Você carrega um clipe com VHS_LoadVideo, descreve o alvo em linguagem simples (por exemplo, "carro vermelho", "pessoa", "xícara de café"), e o nó encontra todas as instâncias correspondentes e as rastreia ao longo dos quadros com IDs estáveis. Ele produz três saídas paralelas: um overlay de preview (máscaras coloridas sobre os quadros originais), uma sequência de máscaras binárias/cinza e um recorte onde apenas os pixels mascarados são mantidos.
Tecnicamente, o nó faz detecção e segmentação de objetos condicionada por texto em cada quadro, depois vincula as detecções ao longo do tempo para manter IDs estáveis. O VHS_LoadVideo fornece a sequência de quadros e fps; o SaveVideo grava cada saída em disco. Para iteração rápida, o parâmetro frame_load_cap do VHS_LoadVideo permite limitar quantos quadros são processados; volte para 0 para rodar tudo. Um nó MarkdownNote no grafo traz lembretes para escrita e teste de prompts.
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
