Wan2.1 VACE Controle de Vídeo é um fluxo guiado de vídeo para vídeo que preserva o movimento e o tempo de um vídeo fonte enquanto reestiliza ou re-caracteriza com um prompt de texto e uma imagem de referência. Ele carrega checkpoints Wan2.1 VACE (1.3B ou 14B) via UNETLoader e VAELoader, codifica seu texto com CLIPTextEncode e condiciona a geração com sinais de controle derivados de pré-processamento simples de imagem (Canny por padrão). GetVideoComponents lê quadros e FPS do clipe de entrada, e TrimVideoLatent mantém a sequência latente alinhada com o intervalo de quadros e resolução escolhidos antes da amostragem.
Nos bastidores, ModelSamplingSD3 configura o agendamento do sampler esperado para Wan2.1 VACE, e KSampler realiza denoising em uma sequência de latentes de vídeo montada por WanVaceToVideo usando seu vídeo de controle, prompt e imagem de referência. VAEDecode converte os latentes finais em quadros, CreateVideo os monta na FPS desejada, e você pode exportar em MP4 (SaveVideo) ou WebP animado (SaveAnimatedWEBP). Um LoRA CausVid opcional (LoraLoader) pode acelerar ou estabilizar o movimento com poucos passos, mas pode ser necessário ajustar sua força. O modelo 14B oferece maior fidelidade (e suporta 720p), mas é mais lento e consome mais VRAM; a variante 1.3B é mais rápida e indicada para saídas 480p.
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 Controle de 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_v2v_api.json");
const asset = client.assets.fromFile("input.png");
wf.setInput("134", "image", asset); // LoadImage
wf.setInput("6", "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















