Intégration ComfyUI Happyhorse-1.0
Le nœud personnalisé officiel Happyhorse pour ComfyUI — connectez directement le modèle vidéo classé n°1 à votre workflow ComfyUI. Installez en 3 étapes et commencez à générer des vidéos cinématographiques en 4K.
Prérequis et installation
Exécutez le nœud personnalisé Happyhorse ComfyUI dans votre environnement ComfyUI local ou cloud. Compatible avec ComfyUI v1.3+ et Python 3.10+.
Prérequis
- ComfyUI v1.3.0 ou ultérieur
- Python 3.10 ou ultérieur
- Une clé API Happyhorse (gratuite à l’inscription)
- Accès Internet pour les appels API d’inférence
Étape 1 — Installer le nœud personnalisé via pip
Ouvrez un terminal dans le répertoire racine de ComfyUI et exécutez :
pip install comfyui-happyhorseÉtape 2 — Redémarrer ComfyUI et charger le nœud
Après l’installation, redémarrez ComfyUI. Dans le graphe de nœuds, clic droit → Add Node → Happyhorse → HappyhorseVideoGenerate. Le nœud apparaîtra dans votre palette sous la catégorie Happyhorse.
# Alternatively, install via ComfyUI Manager:
# Open ComfyUI Manager → Install Custom Nodes → search "happyhorse"
# Click Install → Restart ComfyUIÉtape 3 — Saisir votre clé API
Dans le nœud HappyhorseVideoGenerate, collez votre clé API dans le champ api_key, ou définissez-la comme variable d’environnement :
# Option A: set as environment variable (recommended)
export HAPPYHORSE_API_KEY="hh_xxxxxxxxxxxxxxxxxxxx"
# Option B: enter directly in the node's api_key field
# (do not share workflows with the key embedded)Chargement du workflow
Téléchargez nos fichiers JSON de workflow Happyhorse ComfyUI prêts à l’emploi et faites-les glisser directement sur votre canvas ComfyUI pour démarrer immédiatement.
Workflow simple de prompt vers vidéo. Le meilleur point de départ pour la génération vidéo Happyhorse sur ComfyUI.
happyhorse-t2v-basic.jsonContrôle complet des paramètres : résolution, intensité du mouvement, échelle de guidage, seed. Recommandé aux utilisateurs avancés de Happyhorse 1.0 sur ComfyUI.
happyhorse-t2v-advanced.jsonImportez une image de référence et animez-la avec la physique du mouvement de Happyhorse-1.0 via ComfyUI.
happyhorse-i2v.jsonFaites glisser le fichier .json téléchargé sur votre canvas ComfyUI, ou utilisez Fichier → Ouvrir un workflow. Les nœuds Happyhorse se chargeront automatiquement si le nœud personnalisé est correctement installé.
Configuration de la clé API
Le nœud ComfyUI Happyhorse s’appuie sur l’API REST Happyhorse. Votre clé API authentifie chaque requête de génération de vidéo.
API Happyhorse — Lancement imminent
L’API publique Happyhorse est en phase finale de test et sera disponible très prochainement. Inscrivez-vous sur la liste d’attente pour obtenir un accès anticipé et être parmi les premiers à connecter vos workflows ComfyUI à Happyhorse-1.0.
1. Obtenez votre clé API gratuite
Inscrivez-vous sur Happyhorselab.net — vous recevez 10 crédits de calcul offerts à l’inscription, sans carte bancaire. Accédez à Tableau de bord → Clés API → Créer une nouvelle clé.
2. Configurez le nœud
Le nœud HappyhorseVideoGenerate dispose d’un champ d’entrée api_key. Vous pouvez soit saisir la clé directement, soit référencer une variable d’environnement via le chargeur de secrets intégré à ComfyUI.
# Dans votre nœud de workflow ComfyUI :
{
"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. Suivez votre utilisation
Chaque génération déduit des crédits de votre solde. Consultez vos crédits restants dans Tableau de bord → Crédits. Achetez des packs de calcul supplémentaires sur la page Tarifs, sans abonnement.
Exemples de résultats
Vidéos générées avec le nœud personnalisé Happyhorse pour ComfyUI en utilisant les fichiers de workflow ci-dessus. Happyhorse-1.0 offre une cohérence temporelle et une physique de mouvement cinématographique directement dans ComfyUI.
Séquence aérienne en montagne
“plan aérien cinématographique de sommets enneigés à l'heure dorée, dérive de caméra fluide, nuages volumétriques”
Gros plan sur un personnage
“portrait d'une femme sous une lumière de studio douce, légère rotation de la tête, texture de peau photoréaliste, faible profondeur de champ”
Démo image vers vidéo
“image de produit animée avec un léger mouvement de parallaxe et une variation subtile de l'éclairage ambiant”
Mouvement abstrait
“simulation de peinture fluide en bleu profond et or, motifs organiques tourbillonnants, objectif macro”
FAQ
Questions fréquentes sur l’intégration Happyhorse à ComfyUI, la compatibilité, l’utilisation de l’API et le dépannage.
Quelles versions de ComfyUI sont compatibles avec le nœud personnalisé Happyhorse ?
Le nœud personnalisé Happyhorse pour ComfyUI prend en charge ComfyUI v1.3.0 et les versions ultérieures. Nous recommandons d’utiliser la dernière version stable. Si vous rencontrez une erreur de version, mettez à jour ComfyUI via « git pull » dans votre répertoire ComfyUI, puis réinstallez le nœud avec « pip install --upgrade comfyui-happyhorse ».
Combien de crédits API consomme une génération vidéo ComfyUI ?
Les générations standard en 720p consomment 1 crédit par tranche de 5 secondes de vidéo. Les sorties en 1080p et les sorties upscalées en 4K nécessitent 2 à 4 crédits selon la complexité des mouvements et l’utilisation du moteur physique daVinci-MagiHuman. Vous pouvez suivre l’utilisation en temps réel dans Tableau de bord → Crédits.
J’obtiens l’erreur « Node not found » après l’installation — comment la corriger ?
Cela signifie généralement que ComfyUI n’a pas été redémarré après l’installation. Fermez complètement ComfyUI, puis rouvrez-le. Si l’erreur persiste, vérifiez le chemin d’installation : le paquet comfyui-happyhorse doit apparaître dans le dossier site-packages de votre environnement Python. Exécutez « pip show comfyui-happyhorse » pour confirmer. Vérifiez également que votre version de Python est 3.10 ou supérieure.
Puis-je utiliser le nœud Happyhorse pour ComfyUI sans connexion Internet ?
Non — Happyhorse-1.0 s’exécute sur notre cluster d’inférence cloud ; le nœud ComfyUI nécessite donc une connexion Internet active pour envoyer des requêtes à l’API Happyhorse. L’inférence locale n’est pas prise en charge pour le moment. Les requêtes sont légères (prompts texte ou envois d’images) et les résultats sont renvoyés en streaming de manière efficace.
Existe-t-il un workflow ComfyUI prêt à l’emploi pour la génération image-vers-vidéo Happyhorse ?
Oui. Téléchargez le workflow happyhorse-i2v.json depuis la section Workflow ci-dessus. Chargez-le dans ComfyUI (glissez-déposez sur le canvas ou Fichier → Ouvrir un workflow), connectez votre image de référence au nœud d’entrée Image, ajoutez votre clé API, puis lancez la file d’attente du prompt. Le nœud gère automatiquement l’encodage et la synthèse du mouvement.
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.