ComfyUI: como revisar um fluxo de imagem para vídeo

Para criar um vídeo a partir de uma imagem no ComfyUI, comece pelo template Wan 2.2 14B I2V. Abra o fluxo, identifique onde entra a imagem, confirme os modelos que o grafo pede, descreva um movimento e rode uma tentativa curta. Depois, compare o arquivo salvo com a imagem inicial. O teste termina quando você consegue explicar o que o vídeo preservou, onde ele falhou e qual mudança vale testar a seguir.

Este guia acompanha o exemplo nativo da documentação do ComfyUI. Ele serve para ler um grafo de imagem para vídeo e fazer uma revisão que outra pessoa possa repetir. Os exemplos de produto e cenário abaixo são fictícios. A compatibilidade do seu ambiente depende da versão, dos arquivos de modelo, da memória e dos recursos disponíveis onde o fluxo for executado.

Escolha o template de imagem para vídeo

O ComfyUI organiza a geração em um grafo. Cada bloco, chamado nó, recebe dados, realiza uma etapa ou entrega uma saída. Em imagem para vídeo, a foto é um dado de entrada. A descrição do movimento é outro. O grafo define como imagem, instrução e modelos se combinam até produzir o arquivo. Isso ajuda a responder de onde veio uma mudança: você pode localizar o nó que recebeu a foto, o campo que descreveu a ação e o ponto em que o vídeo foi salvo.

Abra a seção de imagem para vídeo do tutorial oficial do Wan 2.2 no ComfyUI. Ela indica a busca por Wan2.2 14B I2V na biblioteca de templates e fornece o workflow em JSON. A página do mesmo workflow no catálogo oficial mostra os controles expostos e o exemplo de saída. Use esses dois pontos de referência para conferir que a sua cópia corresponde ao fluxo escolhido.

A sigla I2V identifica o caso em que você tem uma imagem inicial. O tutorial também separa o 14B de texto para vídeo, o híbrido 5B e o exemplo de primeiro e último quadro. Eles atendem necessidades diferentes. Se você já tem uma foto que precisa continuar reconhecível, escolha I2V. Se também precisa fornecer uma imagem de chegada, procure o fluxo de primeiro e último quadro. Migrar entre esses templates muda as entradas e a configuração. Trate a troca como um novo teste.

Imagine uma equipe que recebeu uma foto autorizada de um frasco fictício. O pedido é um clipe para estudar enquadramento, com leve aproximação da câmera e fundo estável. A imagem inicial já foi aprovada. A animação pode mudar o tamanho aparente do frasco à medida que a câmera avança, mas precisa preservar a forma da tampa e a posição do rótulo. Essa descrição delimita um teste que cabe em poucos segundos e ajuda a separar problemas de criação de problemas do fluxo.

Leia o grafo do arquivo inicial à saída

O mapa oficial da interface do ComfyUI identifica a biblioteca de nós e modelos, o canvas e o painel lateral com parâmetros e erros. Use o canvas para acompanhar as conexões. Encontre o bloco de imagem e siga o caminho até o nó de saída. Esse percurso é mais rápido que tentar entender cada controle de amostragem de uma vez. Se os nomes ou a disposição variam na sua versão, use a função de cada região como referência.

1. Entrada. O nó LoadImage carrega a imagem inicial. Confirme o nome e a miniatura para evitar enviar ao fluxo um recorte, uma versão antiga ou o arquivo de outro teste.
2. Geração. O template atual reúne a geração em um subgrafo de imagem para vídeo. É ali que convergem a imagem inicial, o texto, os modelos e as configurações usadas para produzir quadros.
3. Saída. O nó SaveVideo recebe o vídeo. Antes de enfileirar, confira se a conexão existe e qual prefixo foi configurado para distinguir o resultado das outras tentativas.

O JSON oficial do template 14B I2V mostra um LoadImage, o subgrafo Image to Video (Wan2.2) e SaveVideo. Dentro do subgrafo, o arquivo inclui a preparação da imagem e do texto, dois carregadores de modelo, etapas de amostragem, decodificação e criação do vídeo. Uma cópia salva em outro momento pode expor mais ou menos controles. Compare o grafo que está aberto e anote sua versão antes de seguir uma captura de tela.

Quando a leitura estiver confusa, escreva três linhas em um registro: qual imagem entrou, qual bloco decide o movimento e qual arquivo deve sair. Volte ao canvas e localize uma conexão para cada linha. Se houver ramos paralelos, verifique qual deles está conectado ao nó final. Um ramo visível na tela pode existir apenas como alternativa. A ligação que chega à saída é o que permite investigar a execução correta.

Confira os modelos e o ambiente antes de rodar

O template referencia arquivos que o seu ambiente precisa conseguir localizar. Para o 14B I2V, o grafo consultado usa dois modelos de difusão da família I2V, um para a etapa de ruído alto e outro para ruído baixo. Também carrega um codificador de texto e um VAE. Em termos práticos, o primeiro conjunto participa da geração dos quadros, o codificador transforma a instrução em informação utilizável pelo modelo e o VAE faz a conversão entre a representação interna e a imagem.

A documentação lista pastas para modelos de difusão, codificadores de texto e VAE em instalações locais. Há uma inconsistência nos nomes da seção de passos: ela cita arquivos T2V em um trecho do tutorial I2V. Já o JSON oficial identifica os dois carregadores como I2V e, na cópia consultada, aponta para variantes FP8. A lista manual do tutorial também mostra variantes FP16. Confira a família, o nome completo e a variante pedidos pelo template aberto. Copiar um nome de outro bloco da página pode fazer você preparar o arquivo errado.

Se a lista de um carregador estiver vazia ou o item selecionado aparecer como ausente, registre o texto exato mostrado no erro. Confira a biblioteca de modelos e a configuração do seu ambiente. A simples presença de um arquivo baixado em uma pasta qualquer não confirma que o ComfyUI o detectou. Em ambiente hospedado, confirme se o template e os modelos aparecem como disponíveis no serviço que você realmente utiliza antes de transferir material de trabalho.

O tutorial também observa que um template ausente pode indicar uma versão desatualizada. Nó ausente e modelo ausente pedem verificações diferentes. Quando falta um tipo de nó, compare a versão e veja se a interface ou o backend registrou falha ao carregar componentes. Quando o nó está disponível e reclama de um arquivo, investigue o seletor do modelo. Evite instalar extensões aleatórias para resolver um erro de arquivo. Elas adicionam dependências e dificultam identificar a causa.

Comece com os parâmetros conservadores do próprio template. A nota de desempenho de uma configuração do projeto descreve o equipamento e as escolhas daquele exemplo. Para estimar se a sua configuração serve, registre a duração escolhida, a resolução e as variantes carregadas, e meça no ambiente que vai usar. Compare esses números com a capacidade e a fila do seu trabalho antes de aumentar a resolução ou rodar várias variações.

Prepare a imagem e descreva o movimento

Antes de abrir o seletor de imagem, escolha um arquivo que já represente o enquadramento que você quer animar. Verifique a nitidez do elemento principal, a posição das bordas importantes e o espaço para o movimento. Se o produto está encostado no limite da foto e você pede uma aproximação, parte dele pode sair do quadro. Corrigir a composição antes do teste é mais econômico que gerar várias versões tentando recuperar uma borda que faltava na referência.

Use uma imagem que sua equipe possa usar no ambiente de execução. Para uma avaliação inicial, uma imagem autorizada de demonstração ou um objeto fictício facilita a troca de arquivos entre quem prepara e quem revisa. Se o original contém um rosto, material ainda não divulgado ou dados de cliente, verifique a autorização e a política de envio antes de usar um serviço hospedado. A escolha do ambiente vem antes da transferência do arquivo.

No texto, descreva primeiro o que se move. Depois acrescente o comportamento da câmera e o que precisa permanecer estável. No teste fictício do frasco, uma instrução possível é: O frasco permanece sobre a mesa. A câmera faz uma aproximação suave em linha reta. Mantenha a tampa, o rótulo e a iluminação da referência. O fundo fica estável ao longo da cena. Essa frase oferece um movimento observável e pontos de comparação. Se a finalidade pede um efeito diferente, ajuste uma ação por vez.

Separe a ação de câmera da ação do objeto. Uma instrução que pede câmera parada, aproximação rápida, rotação do frasco e alteração de fundo mistura quatro decisões. Se o clipe sai confuso, fica difícil escolher o primeiro ajuste. Escreva a versão de referência com uma aproximação. Depois crie outra com rotação do objeto e câmera fixa, mantendo o restante equivalente. Duas tentativas com causas distintas dão mais informação que cinco combinações difíceis de comparar.

Quando a imagem é uma peça de campanha, proteja o que depende de leitura exata. Defina se o texto faz parte da imagem gerada ou será inserido na edição. Em um produto fictício com o rótulo pequeno, compare se as letras ainda são reconhecíveis no tamanho final de exibição. Se essa leitura for obrigatória e o movimento deformar o texto, use o clipe como base visual e avalie uma composição com o texto aplicado depois. Registre essa decisão em vez de aprovar a animação pelo primeiro quadro.

Rode uma tentativa controlada

Salve uma cópia identificável do template antes das mudanças. Carregue a imagem no LoadImage e confira a miniatura. Coloque a instrução no campo de prompt exposto pelo subgrafo. A cópia oficial consultada disponibiliza um controle de duração e mantém outras configurações dentro do subgrafo, incluindo a formação do número de quadros e o FPS. Leia a unidade do campo que você está mexendo. Duração, quadros e taxa de quadros representam medidas diferentes.

Uma estimativa simples ajuda a verificar a saída: um vídeo de cerca de cinco segundos a dezesseis quadros por segundo tem cerca de oitenta quadros. A contagem exata pode depender da fórmula do template e da forma como o arquivo foi codificado. No JSON oficial consultado, o subgrafo contém o cálculo floor(a * b + 1) que liga duração e FPS ao comprimento. Esse detalhe explica por que você deve verificar o resultado final em vez de assumir que o número exposto no campo é a contagem exata do arquivo.

Na barra superior, use uma única execução e um lote de uma tentativa. O mapa oficial diferencia enfileirar pelo botão, enfileirar quando o grafo muda e o modo contínuo. Para este teste, enfileire manualmente depois de conferir as entradas. Assim, cada clipe corresponde a uma decisão. Observe a fila até o término e confirme que a execução gerou uma saída com o prefixo que você reservou.

Registre o nome da imagem, o prompt, a versão do JSON, os modelos selecionados, a resolução, a duração e a identificação da saída. Se a configuração variar a semente a cada tentativa, anote isso. Quando a semente puder ser fixada, mantê-la constante em uma comparação reduz uma variável, mas resultados idênticos ainda dependem do ambiente e da configuração inteira. Para uma equipe, o ganho é conseguir explicar o que foi controlado e o que pode ter variado.

Se a primeira tentativa termina bem, salve-a como referência. Duplique a cópia para mudar apenas o movimento solicitado. Se a primeira falhar com erro de memória, investigue a capacidade antes de repetir automaticamente. Faça uma nova tentativa com uma redução de tamanho ou duração compatível com o template e registre qual foi a alteração. Mudar modelo, resolução e semente juntos perde a relação com a primeira falha.

Revise o vídeo por critérios visuais

No exemplo de saída do catálogo oficial, a cena mostra cavalos correndo sobre um terreno seco, com poeira e deslocamento da câmera. Use o clipe para observar o movimento do conjunto e como o enquadramento acompanha os animais. O exemplo demonstra a saída daquele fluxo. A análise do frasco fictício neste guia exige uma conferência própria, com critérios de forma e legibilidade.

Abra o arquivo salvo e veja o clipe inteiro na velocidade normal. Em seguida, compare um quadro do começo, um do meio e o último. A análise em movimento revela tremor, cortes e mudanças de direção. Os quadros isolados ajudam a perceber deformações no contorno, desaparecimento de um detalhe e mudanças na posição do elemento principal. As duas leituras respondem a perguntas distintas.

• Identidade. Confirme se a forma da tampa, o corpo do frasco e o rótulo continuam reconhecíveis. Marque em que ponto um detalhe começa a mudar.
• Ação. Confira se ocorreu a aproximação pedida e se a cena termina em um enquadramento aproveitável. Descreva a mudança observada em linguagem concreta.
• Continuidade. Compare a iluminação, o fundo e o contorno do objeto entre os quadros. Se houver uma oscilação visual, observe se ela se repete ou aparece uma única vez.
• Entrega. Confira duração, proporção, área disponível para texto e abertura do arquivo no reprodutor onde a equipe vai usá-lo.

Uma nota como “a tampa muda de forma depois da metade” é mais útil que “o vídeo ficou estranho”. Ela permite rever a mesma parte e comparar com outra tentativa. Se a forma muda quando o frasco ocupa quase toda a tela, teste uma aproximação mais curta. Se o problema existe desde o começo, confirme primeiro se você carregou a imagem correta ou se a proporção do fluxo recortou a referência de modo diferente do esperado.

Para a cena fictícia, combine três critérios antes de olhar as versões: frasco reconhecível do início ao fim, movimento suave e fundo estável. Considere uma variação aceitável se o enquadramento mudar sem perder detalhes obrigatórios. Marque para revisão a versão em que o rótulo escorre ou surgem elementos novos que desviam a atenção. Um clipe bonito pode ser útil como estudo de estilo e ainda falhar como peça de produto.

Em trabalhos que precisam de correção em uma etapa posterior, o guia de referências, edição e revisão no Seedance ajuda a formular o que deve mudar e o que deve continuar igual. Para organizar versões em um projeto maior, consulte também o guia de criação e revisão de projetos de vídeo no Google Flow. Cada ferramenta tem seu próprio fluxo. A prática que vale levar adiante é identificar o resultado e a alteração aprovada.

Localize a primeira causa provável

Se o fluxo para antes da geração, comece pela mensagem de erro e pelo primeiro nó com indicação de falha. Guarde o nome do nó, a etapa e o parâmetro apontado. “Modelo ausente”, “tipo de nó desconhecido” e “memória insuficiente” pedem ações diferentes. Ao registrar essas distinções, você poupa outra pessoa de repetir a instalação inteira para resolver uma configuração localizada.

A imagem não aparece. Reabra o seletor do LoadImage, confira a miniatura e valide a conexão ao subgrafo. Se a cópia foi recebida de outra pessoa, o nome que aparece no widget pode referir-se a um arquivo que não existe no seu ambiente. Peça a imagem autorizada com o nome e a versão de origem, selecione-a no local correto e salve a cópia do workflow usada na execução.

O grafo abre, mas o modelo não carrega. Compare os nomes e a família I2V com os dois seletores do template. Mantenha alto e baixo ruído na configuração correspondente. Veja também se o codificador e o VAE estão selecionados. A documentação serve para localizar os recursos, e o JSON mostra os nomes esperados pela cópia consultada. Se a sua cópia é diferente, use a informação do erro para apontar a diferença antes de trocar qualquer arquivo.

A execução termina, mas você não encontra o vídeo. Siga o ramo de geração até SaveVideo. Confira o prefixo, o ambiente em que rodou e a tentativa selecionada na fila. Um trabalho concluído em um ambiente hospedado pode aparecer em outra área que a saída local. Abra o arquivo que corresponde àquela execução, e só então conclua que o problema está no vídeo e precisa de uma alteração criativa.

A imagem se deforma ao animar. Primeiro reduza a ambição da ação, mantendo a referência e a configuração de geração. Para o frasco, substitua a órbita da câmera por aproximação leve. Se continuar, compare o recorte da foto e o tamanho de saída. Faça a segunda alteração em outra execução para distinguir um problema de instrução de um problema de composição. Registre o quadro aproximado em que a deformação aparece.

O custo em tempo ou memória não cabe na rotina. Meça uma tentativa comparável e anote resolução, duração, variante e fila. Use esse registro para decidir se reduz a duração, se testa outra configuração oficial ou se reserva um ambiente diferente. O híbrido 5B descrito pela documentação é outro fluxo e exige nova avaliação de qualidade e compatibilidade. Guarde o vídeo de referência para comparar o que a mudança de template altera no resultado.

Entregue o fluxo para outra pessoa

Monte um pacote pequeno com a cópia do JSON, a referência autorizada, o texto de movimento, a lista de modelos e o vídeo aprovado. Dê nomes que liguem entrada e resultado. Por exemplo, frasco-v01-imagem e frasco-v01-clipe. Acrescente uma nota com o motivo da aprovação e o que ficou fora do teste. Se o arquivo original for confidencial, indique o local autorizado de acesso em vez de duplicá-lo em um canal novo.

Peça a uma segunda pessoa que encontre o nó de entrada, localize o campo de movimento e identifique a saída antes de executar. Se ela não consegue fazer isso sem perguntar, melhore o registro ou os nomes. Se o fluxo vai virar rotina, defina também quem pode trocar os modelos, quando a equipe deve parar por falta de qualidade e onde ficará a versão aprovada. Um guia sobre como estruturar um workflow de IA pode ajudar a documentar essas responsabilidades.

Uma revisão pode terminar em três encaminhamentos concretos: aprovar o clipe para a finalidade descrita, pedir uma nova tentativa com uma única mudança ou registrar que o ambiente ainda precisa ser preparado. Anote qual pessoa fez a conferência e qual arquivo avaliou. Assim, uma saída de demonstração não vira peça final por engano, e a equipe sabe retomar o trabalho a partir da tentativa certa.

Perguntas frequentes sobre ComfyUI e imagem para vídeo

Qual template do ComfyUI devo escolher para animar uma imagem com Wan 2.2?

Procure Wan2.2 14B I2V na biblioteca ou abra o JSON indicado no tutorial oficial. Ele usa uma imagem inicial. Se precisar controlar também o quadro de chegada, consulte a seção oficial de primeiro e último quadro.

Onde coloco a imagem e a instrução de movimento?

Selecione a imagem no LoadImage e escreva a instrução no prompt que alimenta o subgrafo. Confirme visualmente a miniatura e siga a ligação até o bloco de geração antes de clicar em Run.

Como saber se os modelos estão certos?

Confira os seletores que o template realmente pede, os arquivos detectados e a família I2V. A seção de passos do tutorial tem uma divergência com o JSON oficial. Use o grafo e o nome completo do arquivo para verificar a variante.

O template vai rodar no meu computador?

Isso depende da instalação, dos modelos, da resolução, da duração e dos recursos disponíveis. Use o template oficial como referência e faça uma tentativa pequena no ambiente autorizado. Registre a falha ou o desempenho observado antes de planejar um lote.

O que revisar no primeiro vídeo?

Compare o começo, o meio e o fim com a imagem inicial. Verifique identidade visual, movimento pedido, estabilidade e duração. Se algo falhar, anote o ponto aproximado, descreva a diferença e mude uma variável na tentativa seguinte.