Integrazione ufficiale con ComfyUI

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.

01pip install
02Carica nodo
03Aggiungi chiave API

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:

bash
pip install comfyui-happyhorse

Passaggio 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.

bash
# In alternativa, installa tramite ComfyUI Manager:
# Apri ComfyUI Manager → Install Custom Nodes → cerca "happyhorse"
# Fai clic su Install → Riavvia ComfyUI

Passaggio 3 — Inserisci la tua chiave API

Nel nodo HappyhorseVideoGenerate, incolla la tua chiave API nel campo api_key oppure impostala come variabile d’ambiente:

bash
# 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.

Text-to-Video — Base

Workflow semplice da prompt a video. Il miglior punto di partenza per la generazione video con Happyhorse in ComfyUI.

happyhorse-t2v-basic.json
Text-to-Video — Avanzato

Controllo completo dei parametri: risoluzione, intensità del movimento, scala di guida, seed. Consigliato per power user di Happyhorse 1.0 su ComfyUI.

happyhorse-t2v-advanced.json
Image-to-Video

Carica un’immagine di riferimento e animala con la fisica del movimento di Happyhorse-1.0 tramite ComfyUI.

happyhorse-i2v.json

Trascina 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.

In arrivo

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.

Iscriviti alla lista d’attesa

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.

json
# 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.

Happyhorse-1.0 output

Sequenza aerea in montagna

ripresa aerea cinematografica di cime montuose innevate all’ora d’oro, deriva di camera fluida, nuvole volumetriche

4KT2VLandscape
Happyhorse-1.0 output

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

1080pT2VPortrait
Happyhorse-1.0 output

Demo da immagine a video

immagine di prodotto animata con un delicato movimento di parallasse e un cambiamento dell’illuminazione ambientale

720pI2VProduct
Happyhorse-1.0 output

Movimento astratto

simulazione di vernice fluida in blu intenso e oro, motivi organici vorticosi, obiettivo macro

1080pT2VAbstract

FAQ

Domande frequenti sull’integrazione Happyhorse con ComfyUI, compatibilità, utilizzo delle API e risoluzione dei problemi.

1

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.

2

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.

3

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.

4

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.

5

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.