Integración de Happyhorse-1.0 para ComfyUI
El nodo personalizado oficial de Happyhorse para ComfyUI: conecta directamente el modelo de vídeo n.º 1 del ranking a tu flujo de trabajo en ComfyUI. Instálalo en 3 pasos y empieza a generar vídeo cinematográfico en 4K.
Requisitos e instalación
Pon en marcha el nodo personalizado de Happyhorse para ComfyUI en tu entorno local o en la nube de ComfyUI. Compatible con ComfyUI v1.3+ y Python 3.10+.
Requisitos
- ComfyUI v1.3.0 o posterior
- Python 3.10 o posterior
- Una clave de API de Happyhorse (gratuita al registrarte)
- Acceso a Internet para las llamadas a la API de inferencia
Paso 1 — Instala el nodo personalizado mediante pip
Abre una terminal en el directorio raíz de ComfyUI y ejecuta:
pip install comfyui-happyhorsePaso 2 — Reinicia ComfyUI y carga el nodo
Tras la instalación, reinicia ComfyUI. En el grafo de nodos, haz clic derecho → Añadir nodo → Happyhorse → HappyhorseVideoGenerate. El nodo aparecerá en tu paleta bajo la categoría Happyhorse.
# Como alternativa, instala mediante ComfyUI Manager:
# Abre ComfyUI Manager → Install Custom Nodes → busca "happyhorse"
# Haz clic en Install → Reinicia ComfyUIPaso 3 — Introduce tu clave de API
En el nodo HappyhorseVideoGenerate, pega tu clave de API en el campo api_key o configúrala como variable de entorno:
# Opción A: configurar como variable de entorno (recomendado)
export HAPPYHORSE_API_KEY="hh_xxxxxxxxxxxxxxxxxxxx"
# Opción B: introducirla directamente en el campo api_key del nodo
# (no compartas flujos de trabajo con la clave incrustada)Cargando el flujo de trabajo
Descarga nuestros archivos JSON de flujo de trabajo preconfigurados de Happyhorse para ComfyUI y arrástralos directamente a tu lienzo de ComfyUI para empezar al instante.
Flujo de trabajo sencillo de prompt a vídeo. El mejor punto de partida para la generación de vídeo con happyhorse en ComfyUI.
happyhorse-t2v-basic.jsonControl total de parámetros: resolución, intensidad del movimiento, escala de guía y semilla. Recomendado para usuarios avanzados de Happyhorse 1.0 en ComfyUI.
happyhorse-t2v-advanced.jsonSube una imagen de referencia y anímala con la física de movimiento de Happyhorse-1.0 a través de ComfyUI.
happyhorse-i2v.jsonArrastra el archivo .json descargado a tu lienzo de ComfyUI o usa Archivo → Abrir flujo de trabajo. Los nodos de Happyhorse se cargarán automáticamente si el nodo personalizado está instalado correctamente.
Configuración de la clave de API
El nodo de ComfyUI de Happyhorse utiliza internamente la API REST de Happyhorse. Tu clave de API autentica cada solicitud de generación de vídeo.
API de Happyhorse — Lanzamiento próximamente
La API pública de Happyhorse está en fase final de pruebas y estará disponible en breve. Únete a la lista de espera para obtener acceso anticipado y ser el primero en conectar tus flujos de trabajo de ComfyUI a Happyhorse-1.0.
1. Obtén tu clave de API gratuita
Regístrate en Happyhorselab.net: recibirás 10 créditos de cómputo gratis al registrarte, sin necesidad de tarjeta de crédito. Ve a Panel → Claves de API → Crear nueva clave.
2. Configura el nodo
El nodo HappyhorseVideoGenerate tiene un campo de entrada api_key. Puedes escribir la clave directamente o referenciar una variable de entorno mediante el cargador de secretos integrado de 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. Supervisa el uso
Cada generación descuenta créditos de tu saldo. Consulta los créditos restantes en Panel → Créditos. Compra paquetes de cómputo adicionales en la página de Precios, sin necesidad de suscripción.
Resultados de ejemplo
Vídeos generados con el nodo personalizado Happyhorse para ComfyUI usando los archivos de flujo de trabajo anteriores. Happyhorse-1.0 ofrece consistencia temporal y física de movimiento cinematográfica directamente dentro de ComfyUI.
Secuencia aérea de montaña
“toma aérea cinematográfica de picos montañosos nevados durante la hora dorada, deriva de cámara suave, nubes volumétricas”
Primer plano del personaje
“retrato de una mujer con luz suave de estudio, ligero giro de cabeza, textura de piel fotorrealista, profundidad de campo reducida”
Demostración de imagen a vídeo
“imagen de producto animada con un suave movimiento de paralaje y un cambio sutil de iluminación ambiental”
Movimiento abstracto
“simulación de pintura fluida en azul profundo y dorado, patrones orgánicos en remolino, lente macro”
Preguntas frecuentes
Preguntas habituales sobre la integración de Happyhorse con ComfyUI, la compatibilidad, el uso de la API y la resolución de problemas.
¿Qué versiones de ComfyUI son compatibles con el nodo personalizado de Happyhorse?
El nodo personalizado de Happyhorse para ComfyUI es compatible con ComfyUI v1.3.0 y versiones posteriores. Recomendamos usar la última versión estable. Si aparece un error de versión, actualiza ComfyUI con git pull en el directorio de ComfyUI y reinstala el nodo con pip install --upgrade comfyui-happyhorse.
¿Cuántos créditos de API consume una generación de vídeo en ComfyUI?
Las generaciones estándar en 720p consumen 1 crédito por cada 5 segundos de vídeo. Las salidas en 1080p y 4K reescaladas requieren entre 2 y 4 créditos, según la complejidad del movimiento y el uso del motor de físicas daVinci-MagiHuman. Puedes supervisar el uso en tiempo real en Panel de control → Créditos.
Me aparece el error «Node not found» después de instalarlo. ¿Cómo lo soluciono?
Normalmente significa que ComfyUI no se reinició tras la instalación. Cierra ComfyUI por completo y vuelve a abrirlo. Si el error persiste, verifica la ruta de instalación: el paquete comfyui-happyhorse debería aparecer en la carpeta site-packages de tu entorno de Python. Ejecuta pip show comfyui-happyhorse para confirmarlo. Comprueba también que tu versión de Python sea 3.10 o superior.
¿Puedo usar el nodo de Happyhorse para ComfyUI sin conexión a internet?
No. Happyhorse-1.0 se ejecuta en nuestro clúster de inferencia en la nube, por lo que el nodo de ComfyUI requiere una conexión a internet activa para enviar solicitudes a la API de Happyhorse. Actualmente no se admite la inferencia local. Las solicitudes son ligeras (prompts de texto o cargas de imágenes) y los resultados se transmiten de vuelta de forma eficiente.
¿Hay un flujo de trabajo de ComfyUI ya preparado para la generación de imagen a vídeo con Happyhorse?
Sí. Descarga el flujo de trabajo happyhorse-i2v.json desde la sección Workflow de arriba. Cárgalo en ComfyUI (arrástralo al lienzo o ve a Archivo → Abrir flujo de trabajo), conecta tu imagen de referencia al nodo de entrada Image, añade tu clave de API y pon el prompt en cola. El nodo se encarga automáticamente de la codificación y la síntesis de movimiento.
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.