Wan2.1 VACE Referência para Vídeo transforma uma única imagem em um vídeo curto que preserva o estilo e o tema da referência enquanto introduz movimento guiado por prompts de texto. O núcleo do fluxo é o nó WanVaceToVideo, que funde uma imagem de referência carregada (LoadImage) com texto de prompt codificado por CLIPTextEncode. O backbone de difusão é fornecido pelos modelos Wan 2.1 VACE—use UNETLoader e VAELoader no grupo “Carregue modelos aqui” para selecionar Wan2.1-VACE-1.3B ou Wan2.1-VACE-14B. Um nó ModelSamplingSD3 configura o sampler, e KSampler faz o denoising com os steps e cfg scale escolhidos. Se precisar de adaptadores de estilo, LoraLoader permite aplicar um LoRA compatível com a mesma família de modelos de difusão.
Após a amostragem, VAEDecode reconstrói os quadros a partir dos latentes. TrimVideoLatent ajuda a definir a duração exata, e o grupo “Controle do Primeiro Quadro” (ImageToMask, SolidMask, MaskToImage, RepeatImageBatch) pode travar ou proteger partes do quadro inicial para maior retenção de identidade ou composição. Nós PreviewImage permitem QC rápido durante a iteração. Por fim, CreateVideo agrega os quadros e você pode exportar via SaveVideo (MP4) ou SaveAnimatedWEBP para prévias leves. Orientação do autor: steps=20 e cfg=6.0 funcionam bem; com CausVid LoRA use menos steps (2–4) e cfg baixo (~1.0). Para resolução, VACE-1.3B é indicado para 480p, enquanto VACE-14B entrega maior qualidade e suporta 480p e 720p, com tempo de renderização maior.
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 "Wan2.1 VACE referência para vídeo" (TypeScript)
import { Comfy } from "@comfyorg/sdk";
const client = new Comfy({ apiKey: "comfyui-..." });
// This workflow, exported in API format (see note below)
const wf = await client.workflows.fromFile("video_wan_vace_14B_ref2v_api.json");
const asset = client.assets.fromFile("input.png");
wf.setInput("73", "image", asset); // LoadImage
wf.setInput("105", "text", "your prompt here"); // CLIPTextEncode
const job = await client.run(wf);
await job.getOutputs("70")[0].toFile("output.png"); // SaveAnimatedWEBPO 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
