Integração do Happyhorse-1.0 com o ComfyUI
O nó personalizado oficial do Happyhorse para o ComfyUI — conecte o modelo de vídeo nº 1 do ranking diretamente ao seu workflow do ComfyUI. Instale em 3 passos e comece a gerar vídeos cinematográficos em 4K.
Requisitos e instalação
Coloque o nó personalizado do Happyhorse ComfyUI para funcionar no seu ambiente ComfyUI local ou na nuvem. Compatível com ComfyUI v1.3+ com Python 3.10+.
Requisitos
- ComfyUI v1.3.0 ou superior
- Python 3.10 ou superior
- Uma chave de API da Happyhorse (gratuita no cadastro)
- Acesso à internet para chamadas à API de inferência
Etapa 1 — Instale o nó personalizado via pip
Abra um terminal no diretório raiz do seu ComfyUI e execute:
pip install comfyui-happyhorseEtapa 2 — Reinicie o ComfyUI e carregue o nó
Após a instalação, reinicie o ComfyUI. No grafo de nós, clique com o botão direito → Adicionar nó → Happyhorse → HappyhorseVideoGenerate. O nó aparecerá na sua paleta na categoria Happyhorse.
# Como alternativa, instale pelo ComfyUI Manager:
# Abra o ComfyUI Manager → Install Custom Nodes → pesquise por "happyhorse"
# Clique em Install → Reinicie o ComfyUIEtapa 3 — Informe sua chave de API
No nó HappyhorseVideoGenerate, cole sua chave de API no campo api_key ou defina-a como uma variável de ambiente:
# Opção A: definir como variável de ambiente (recomendado)
export HAPPYHORSE_API_KEY="hh_xxxxxxxxxxxxxxxxxxxx"
# Opção B: inserir diretamente no campo api_key do nó
# (não compartilhe workflows com a chave embutida)Carregando o Workflow
Baixe nossos arquivos JSON de workflow prontos do Happyhorse para o ComfyUI e arraste-os diretamente para o seu canvas do ComfyUI para começar imediatamente.
Workflow simples de prompt para vídeo. O melhor ponto de partida para geração de vídeo no ComfyUI com Happyhorse.
happyhorse-t2v-basic.jsonControle total de parâmetros: resolução, intensidade de movimento, escala de orientação, seed. Recomendado para usuários avançados do Happy Horse 1.0 no ComfyUI.
happyhorse-t2v-advanced.jsonEnvie uma imagem de referência e anime-a com a física de movimento do Happyhorse-1.0 via ComfyUI.
happyhorse-i2v.jsonArraste o arquivo .json baixado para o seu canvas do ComfyUI ou use Arquivo → Abrir Workflow. Os nós do Happyhorse serão carregados automaticamente se o nó personalizado estiver instalado corretamente.
Configuração da Chave de API
O nó Happyhorse do ComfyUI usa a API REST da Happyhorse por trás. Sua chave de API autentica cada solicitação de geração de vídeo.
Happyhorse API — Lançamento em breve
A API pública da Happyhorse está na fase final de testes e ficará disponível muito em breve. Entre na lista de espera para obter acesso antecipado e ser o primeiro a conectar seus fluxos de trabalho do ComfyUI ao Happyhorse-1.0.
1. Obtenha sua chave de API gratuita
Cadastre-se em Happyhorselab.net — você recebe 10 créditos gratuitos de computação ao se registrar, sem necessidade de cartão de crédito. Vá em Painel → Chaves de API → Criar nova chave.
2. Configure o nó
O nó HappyhorseVideoGenerate tem um campo de entrada api_key. Você pode digitar a chave diretamente ou referenciar uma variável de ambiente usando o carregador de segredos integrado do ComfyUI.
# In your ComfyUI workflow node:
{
"api_key": "hh_xxxxxxxxxxxxxxxxxxxx",
"model": "happyhorse-1.0",
"prompt": "cinematic aerial shot of mountain peaks at sunrise",
"resolution": "1280x720",
"duration": 5,
"guidance_scale": 7.5,
"seed": 42
}3. Acompanhe o uso
Cada geração desconta créditos do seu saldo. Confira seus créditos restantes em Painel → Créditos. Compre pacotes adicionais de computação na página de Preços, sem necessidade de assinatura.
Exemplos de Resultados
Vídeos gerados com o nó personalizado Happyhorse para ComfyUI usando os arquivos de workflow acima. O Happyhorse-1.0 entrega consistência temporal e física de movimento cinematográfica diretamente no ComfyUI.
Sequência Aérea nas Montanhas
“take aéreo cinematográfico de picos de montanhas cobertos de neve na hora dourada, deriva suave de câmera, nuvens volumétricas”
Close no Personagem
“retrato de uma mulher em luz suave de estúdio, leve virada de cabeça, textura de pele fotorrealista, profundidade de campo rasa”
Demonstração de Imagem para Vídeo
“imagem de produto animada com suave movimento de paralaxe e mudança sutil de iluminação ambiente”
Movimento Abstrato
“simulação de tinta fluida em azul profundo e dourado, padrões orgânicos em espiral, lente macro”
Perguntas frequentes (FAQ)
Perguntas comuns sobre a integração do Happyhorse com o ComfyUI, compatibilidade, uso da API e solução de problemas.
Quais versões do ComfyUI são compatíveis com o nó personalizado da Happyhorse?
O nó personalizado Happyhorse para ComfyUI oferece suporte ao ComfyUI v1.3.0 e versões posteriores. Recomendamos usar a versão estável mais recente. Se você encontrar um erro de versão, atualize o ComfyUI com git pull no diretório do ComfyUI e reinstale o nó com pip install --upgrade comfyui-happyhorse.
Quantos créditos de API uma geração de vídeo no ComfyUI consome?
Gerações padrão em 720p consomem 1 crédito a cada 5 segundos de vídeo. Saídas em 1080p e 4K com upscaling exigem de 2 a 4 créditos, dependendo da complexidade do movimento e do uso do motor de física daVinci-MagiHuman. Você pode acompanhar o uso em tempo real no Painel → Créditos.
Recebo um erro de "Nó não encontrado" após instalar — como corrigir?
Isso geralmente significa que o ComfyUI não foi reiniciado após a instalação. Feche completamente e abra novamente o ComfyUI. Se o erro persistir, verifique o caminho de instalação: o pacote comfyui-happyhorse deve aparecer em site-packages do seu ambiente Python. Execute pip show comfyui-happyhorse para confirmar. Verifique também se sua versão do Python é 3.10 ou superior.
Posso usar o nó Happyhorse no ComfyUI sem conexão com a internet?
Não — o Happyhorse-1.0 roda no nosso cluster de inferência em nuvem, então o nó do ComfyUI exige uma conexão ativa com a internet para enviar solicitações à API da Happyhorse. A inferência local não é suportada no momento. As solicitações são leves (prompts de texto ou envio de imagens) e os resultados são transmitidos de volta de forma eficiente.
Existe um workflow do ComfyUI pronto para geração de imagem para vídeo (image-to-video) da Happyhorse?
Sim. Baixe o workflow happyhorse-i2v.json na seção Workflow acima. Carregue-o no ComfyUI (arraste para a tela ou Arquivo → Abrir workflow), conecte sua imagem de referência ao nó de entrada Image, adicione sua chave de API e coloque o prompt na fila. O nó faz automaticamente a codificação e a síntese de movimento.
Ready to use Happyhorse-1.0 in ComfyUI?
Get your free API key, download a workflow, and generate your first video in under 5 minutes.