Integrazione Happyhorse-1.0 con ComfyUI
Il nodo personalizzato ufficiale di Happyhorse per ComfyUI — collega direttamente al tuo workflow ComfyUI il modello video n.1 in classifica. Installa in 3 passaggi e inizia a generare video cinematografici in 4K.
Requisiti e installazione
Metti in esecuzione il nodo personalizzato Happyhorse per ComfyUI nel tuo ambiente ComfyUI locale o cloud. Supporta ComfyUI v1.3+ con Python 3.10+.
Requisiti
- ComfyUI v1.3.0 o successivo
- Python 3.10 o successivo
- Una chiave API Happyhorse (gratuita alla registrazione)
- Accesso a Internet per le chiamate API di inferenza
Passaggio 1 — Installa il nodo personalizzato tramite pip
Apri un terminale nella directory principale di ComfyUI ed esegui:
pip install comfyui-happyhorsePassaggio 2 — Riavvia ComfyUI e carica il nodo
Dopo l’installazione, riavvia ComfyUI. Nel grafico dei nodi, fai clic destro → Aggiungi nodo → Happyhorse → HappyhorseVideoGenerate. Il nodo comparirà nella palette sotto la categoria Happyhorse.
# In alternativa, installa tramite ComfyUI Manager:
# Apri ComfyUI Manager → Install Custom Nodes → cerca "happyhorse"
# Fai clic su Install → Riavvia ComfyUIPassaggio 3 — Inserisci la tua chiave API
Nel nodo HappyhorseVideoGenerate, incolla la tua chiave API nel campo api_key oppure impostala come variabile d’ambiente:
# Opzione A: imposta come variabile d’ambiente (consigliato)
export HAPPYHORSE_API_KEY="hh_xxxxxxxxxxxxxxxxxxxx"
# Opzione B: inserisci direttamente nel campo api_key del nodo
# (non condividere i workflow con la chiave incorporata)Caricamento del workflow
Scarica i file JSON del workflow Happyhorse ComfyUI già pronti e trascinali direttamente nella tua canvas di ComfyUI per iniziare subito.
Workflow semplice da prompt a video. Il miglior punto di partenza per la generazione video con Happyhorse in ComfyUI.
happyhorse-t2v-basic.jsonControllo completo dei parametri: risoluzione, intensità del movimento, scala di guida, seed. Consigliato per power user di Happyhorse 1.0 su ComfyUI.
happyhorse-t2v-advanced.jsonCarica un’immagine di riferimento e animala con la fisica del movimento di Happyhorse-1.0 tramite ComfyUI.
happyhorse-i2v.jsonTrascina il file .json scaricato sulla canvas di ComfyUI oppure usa File → Apri workflow. I nodi Happyhorse verranno caricati automaticamente se il nodo personalizzato è installato correttamente.
Configurazione della chiave API
Il nodo ComfyUI di Happyhorse utilizza internamente la REST API di Happyhorse. La tua chiave API autentica ogni richiesta di generazione video.
Happyhorse API — In arrivo a breve
La API pubblica di Happyhorse è nelle fasi finali di test e sarà disponibile a brevissimo. Iscriviti alla lista d’attesa per ottenere l’accesso in anteprima ed essere tra i primi a collegare i tuoi workflow di ComfyUI a Happyhorse-1.0.
1. Ottieni la tua chiave API gratuita
Registrati su Happyhorselab.net — ricevi 10 crediti di calcolo gratuiti al momento della registrazione, senza carta di credito. Vai su Dashboard → API Keys → Create New Key.
2. Configura il nodo
Il nodo HappyhorseVideoGenerate ha un campo di input api_key. Puoi inserire la chiave direttamente oppure fare riferimento a una variabile d’ambiente usando il loader di segreti integrato in ComfyUI.
# Nel nodo del tuo 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. Monitora l’utilizzo
Ogni generazione scala crediti dal tuo saldo. Controlla i crediti rimanenti in Dashboard → Credits. Puoi acquistare pacchetti di calcolo aggiuntivi nella pagina Pricing, senza necessità di abbonamento.
Output di esempio
Video generati con il nodo personalizzato Happyhorse per ComfyUI utilizzando i file di workflow sopra. Happyhorse-1.0 offre coerenza temporale e fisica del movimento di taglio cinematografico direttamente in ComfyUI.
Sequenza aerea in montagna
“ripresa aerea cinematografica di cime montuose innevate all’ora d’oro, deriva di camera fluida, nuvole volumetriche”
Primo piano del personaggio
“ritratto di una donna in morbida luce da studio, lieve rotazione della testa, texture della pelle fotorealistica, ridotta profondità di campo”
Demo da immagine a video
“immagine di prodotto animata con un delicato movimento di parallasse e un cambiamento dell’illuminazione ambientale”
Movimento astratto
“simulazione di vernice fluida in blu intenso e oro, motivi organici vorticosi, obiettivo macro”
FAQ
Domande frequenti sull’integrazione Happyhorse con ComfyUI, compatibilità, utilizzo delle API e risoluzione dei problemi.
Quali versioni di ComfyUI sono compatibili con il nodo personalizzato Happyhorse?
Il nodo personalizzato Happyhorse per ComfyUI supporta ComfyUI v1.3.0 e versioni successive. Consigliamo di utilizzare l’ultima release stabile. Se riscontri un errore di versione, aggiorna ComfyUI con git pull nella directory di ComfyUI e reinstalla il nodo con pip install --upgrade comfyui-happyhorse.
Quanti crediti API consuma una singola generazione video in ComfyUI?
Le generazioni standard a 720p consumano 1 credito ogni 5 secondi di video. Gli output 1080p e 4K upscalati richiedono 2–4 crediti in base alla complessità del movimento e all’uso del motore fisico daVinci-MagiHuman. Puoi monitorare l’utilizzo in tempo reale nella Dashboard → pagina Crediti.
Dopo l’installazione compare l’errore “Node not found”: come posso risolvere?
Di solito significa che ComfyUI non è stato riavviato dopo l’installazione. Chiudi completamente e riapri ComfyUI. Se l’errore persiste, verifica il percorso di installazione: il pacchetto comfyui-happyhorse dovrebbe essere presente nella cartella site-packages del tuo ambiente Python. Esegui pip show comfyui-happyhorse per confermare. Controlla inoltre che la tua versione di Python sia 3.10 o successiva.
Posso usare il nodo Happyhorse per ComfyUI senza una connessione a internet?
No: Happyhorse-1.0 gira sul nostro cluster cloud di inferenza, quindi il nodo ComfyUI richiede una connessione internet attiva per inviare richieste alle API Happyhorse. L’inferenza in locale al momento non è supportata. Le richieste sono leggere (prompt testuali o upload di immagini) e i risultati vengono trasmessi in streaming in modo efficiente.
Esiste un workflow ComfyUI già pronto per la generazione image-to-video di Happyhorse?
Sì. Scarica il workflow happyhorse-i2v.json dalla sezione Workflow qui sopra. Caricalo in ComfyUI (trascinalo sulla canvas oppure File → Open Workflow), collega l’immagine di riferimento al nodo di input Image, inserisci la tua API key e metti in coda il prompt. Il nodo gestisce automaticamente la codifica e la sintesi del 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.
