Pesquisar
Português
Conteúdo
  1. Tutorial de ComfyUI
Primeiros passos
  1. O que é ComfyUI
  2. Instalar o ComfyUI
  3. Visão geral da interface
  4. Download de modelos e pastas
  5. Primeira imagem (texto em imagem)
Técnicas essenciais
  1. Parâmetros do KSampler
  2. Técnicas de prompt
  3. Imagem para imagem (img2img)
  4. Inpainting e outpainting
  5. LoRA
  6. ControlNet
  7. Upscale de imagens
Recursos avançados
  1. Nós personalizados e Manager
  2. Modelos de nova geração, como Flux
  3. Geração de vídeos com IA
  4. Automatizar com a API
  5. Perguntas frequentes e erros

Perguntas frequentes e solução de problemas do ComfyUI

Falta de memória da GPU: CUDA out of memory / allocation failed

Tente as opções a seguir, em ordem:

  1. Reduza a resolução ou o batch_size.
  2. Use modelos quantizados em FP8 ou GGUF.
  3. Para imagens grandes, use VAE Decode (Tiled) para decodificar o VAE.
  4. Feche outros programas que estejam usando a memória da GPU (navegador, jogos e outras ferramentas de IA).
  5. Adicione --lowvram ao iniciar.
  6. Clique em “Unload models” na interface (a posição varia conforme a versão) ou reinicie o ComfyUI.

Nó destacado em vermelho

Ao executar, uma mensagem de erro informa qual nó e qual entrada estão com problema:

Conteúdo da mensagemCausa
Required input is missingUma entrada obrigatória não está conectada
Value not in listO arquivo de modelo selecionado não existe (por exemplo, você carregou um workflow de outra pessoa, mas não tem aquele modelo). Selecione outro modelo ou baixe o necessário
O título do nó aparece em vermelho e não é reconhecidoFalta um nó personalizado. Use Install Missing Custom Nodes no Manager

Não encontro o modelo que acabei de baixar

  • Confirme se ele está na pasta correta (veja Download de modelos e pastas).
  • Pressione R para atualizar ou reinicie o ComfyUI.
  • Confirme se o download do arquivo foi concluído (compare o tamanho do arquivo).

A imagem gerada está totalmente preta

  • Problema de precisão do VAE: tente usar o VAE específico do modelo ou outro VAE.
  • Você usou uma combinação incompatível (por exemplo, modelo e VAE de famílias diferentes).
  • Algumas GPUs podem gerar imagens pretas com certas configurações de precisão. Confira as mensagens de aviso no terminal.

A qualidade da imagem está ruim ou estranha

SintomaO que verificar
Imagem borrada, com poucos detalhesPoucos steps; resolução muito baixa
Saturação excessiva, imagem com artefatosCFG muito alto; intensidade do LoRA muito alta
Pessoas duplicadas, composição estranhaResolução muito acima do valor recomendado para o modelo; gere primeiro e depois amplie
A imagem não se parece em nada com o promptCFG muito baixo; LoRA / ControlNet incompatível com a versão do modelo
Dedos a mais, rosto deformadoLimitações do modelo; corrija com pintura de áreas específicas

A geração está muito lenta

  • Confira nas mensagens de inicialização do terminal se a GPU está sendo usada (Device: cuda:0 ...).
  • Se o terminal exibir mensagens como loaded partially, o modelo não cabe na memória da GPU e parte dele está na memória do sistema. Use uma versão menor do modelo.
  • Na primeira execução, o modelo precisa ser carregado; as próximas serão mais rápidas.

Torch not compiled with CUDA enabled

Você instalou a versão de CPU do PyTorch. Reinstale a versão para GPU no ambiente Python do ComfyUI:

pip uninstall torch torchvision torchaudio
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

(Use a versão do CUDA recomendada no README do ComfyUI.)

Não consigo iniciar após a atualização

Na maioria dos casos, um nó personalizado é incompatível com a nova versão:

  1. Confira as mensagens de erro no terminal para identificar o nome do nó com problema.
  2. Mova temporariamente esse nó para fora da pasta custom_nodes e tente iniciar novamente.
  3. Atualize o nó ou confira a página dele no GitHub para ver se já existe uma correção.

Problemas com caminhos ou nomes de arquivo em chinês

Alguns nós personalizados podem apresentar erros quando os modelos, as imagens ou o caminho de instalação incluem caracteres chineses ou especiais. Prefira usar um caminho de instalação em inglês e sem espaços.

Arrasto uma imagem com um workflow para dentro, mas nada acontece

As informações do workflow foram removidas da imagem (por exemplo, após a compactação por uma rede social ou aplicativo de mensagens). Obtenha o arquivo PNG ou JSON original.

Outros computadores da rede local não conseguem se conectar

Adicione --listen ao iniciar (por exemplo, --listen 0.0.0.0) e confirme se o firewall permite a porta 8188. O ComfyUI não tem proteção por nome de usuário e senha; disponibilize-o apenas em uma rede confiável.

Onde posso encontrar mais workflows?

  • Os modelos incluídos no ComfyUI
  • As páginas oficiais dos modelos (geralmente incluem workflows de exemplo)
  • Workflows compartilhados em sites da comunidade (confira se os nós personalizados necessários são confiáveis)

Atualizado 12 de outubro de 2026