Gerar imagem
Executa um nó simples de geração de imagens do PoYo e guarda a imagem devolvida.
Todas as integrações
Guia de integração
Instalar o PoYo no ComfyUI
Workflows visuais de IA locais
Usa os modelos de imagem, vídeo e áudio do PoYo ao lado dos nós locais do ComfyUI, com ligações visuais e ficheiros de saída.
Antes de começares
- ComfyUI 0.32.0 ou mais recente
- Git e uma chave de API do PoYo
Três passos para uma configuração verificada
Conclui os passos por ordem. Cada passo indica onde agir e o resultado que confirma que podes continuar.
- 1
Verifica a versão do ComfyUI
Atualiza o ComfyUI antes de instalares o pacote de nós, se a tua versão for anterior à 0.32.0.
Continua quando: O ComfyUI indica a versão 0.32.0 ou mais recente. - 2
Instala os nós e reinicia o ComfyUI
Clona o repositório oficial para custom_nodes e reinicia por completo o ComfyUI para que carregue o novo pacote.
Terminalcd ComfyUI/custom_nodes git clone https://github.com/PoyoAPI/poyo-comfyui.gitContinua quando: Ao pesquisares PoYo no menu de nós, aparecem os nós do PoYo instalados. - 3
Configura a chave de API
Define a chave antes de iniciares o ComfyUI ou usa o comando de configuração local. Não coles a chave nos campos dos nós do workflow.
Windowsset POYO_API_KEY=your_poyo_api_key set POYO_BASE_URL=https://api.poyo.aimacOS / Linuxexport POYO_API_KEY=your_poyo_api_key export POYO_BASE_URL=https://api.poyo.aiAlternativa de configuração localpython -m poyo_nodes.configureContinua quando: Os nós do PoYo conseguem carregar o catálogo de modelos em direto sem um erro de autenticação.
Executa o teu primeiro workflow do PoYo
Usa o exemplo oficial para testares a instalação e as credenciais antes de construíres um workflow maior.
Escolhe um workflow de exemplo
Começa com um pequeno workflow que corresponda ao comportamento que queres verificar.
Submeter e aguardar
Submete um modelo genérico do catálogo, aguarda pela conclusão e guarda o ficheiro de resultado.
Como importar
- 1Transfere o ficheiro JSON.
- 2Arrasta-o para o canvas do ComfyUI ou escolhe Workflow → Open.
- 3Seleciona um modelo, confirma as entradas e escolhe depois Queue Prompt.
- 1Transfere um workflow de exemplo oficial do repositório.
- 2Abre-o no ComfyUI e seleciona um modelo do catálogo em direto.
- 3Coloca o prompt em fila e aguarda que a tarefa do PoYo termine.
- 4Encontra o resultado guardado em ComfyUI/output/poyo.
Primeiro sucesso: A fila termina e há um resultado gerado disponível em ComfyUI/output/poyo.
Se algo não funcionar
- Os nós do PoYo não aparecem
- Reinicia o ComfyUI por completo e procura na consola de arranque um erro de importação de poyo_nodes.
- O catálogo não carrega
- Verifica a chave de API e a ligação de rede e reinicia depois de alterares as variáveis de ambiente.
- O workflow não encontra uma saída
- Aguarda que a tarefa chegue ao estado finished e verifica depois o nó Save Result File e a pasta ComfyUI/output/poyo.
Detalhes técnicos
Estes detalhes são importantes nas integrações em produção, mas não são pré-requisitos para a primeira execução com sucesso.
- As credenciais ficam fora dos ficheiros de workflow exportados.
- As tarefas mantêm os estados públicos not_started, running, finished e failed.
- Os pedidos chamam diretamente os endpoints REST atuais do PoYo e incluem uma etiqueta X-PoYo-Source.