Offizielle ComfyUI-Integration

Happyhorse-1.0 ComfyUI-Integration

Der offizielle Happyhorse-ComfyUI-Custom-Node — verbinde das Video-Modell auf Platz 1 direkt mit deinem ComfyUI-Workflow. In 3 Schritten installiert und sofort startklar für cineastische 4K-Videos.

01pip install
02Node laden
03API-Schlüssel hinzufügen

Voraussetzungen & Installation

Richte den Happyhorse-ComfyUI-Custom-Node in deiner lokalen oder Cloud-ComfyUI-Umgebung ein. Unterstützt ComfyUI v1.3+ mit Python 3.10+.

Voraussetzungen

  • ComfyUI v1.3.0 oder höher
  • Python 3.10 oder höher
  • Ein Happyhorse-API-Schlüssel (kostenlos bei der Registrierung)
  • Internetzugang für Inference-API-Aufrufe

Schritt 1 — Custom Node per pip installieren

Öffne ein Terminal im Stammverzeichnis deiner ComfyUI-Installation und führe Folgendes aus:

bash
pip install comfyui-happyhorse

Schritt 2 — ComfyUI neu starten und Node laden

Starte ComfyUI nach der Installation neu. Klicke im Node-Graph mit der rechten Maustaste → Add Node → Happyhorse → HappyhorseVideoGenerate. Der Node erscheint in deiner Palette unter der Kategorie Happyhorse.

bash
# Alternativ über den ComfyUI Manager installieren:
# ComfyUI Manager öffnen → Install Custom Nodes → nach "happyhorse" suchen
# Auf Install klicken → ComfyUI neu starten

Schritt 3 — API-Schlüssel eingeben

Füge im HappyhorseVideoGenerate-Node deinen API-Schlüssel in das Feld api_key ein oder setze ihn als Umgebungsvariable:

bash
# Option A: als Umgebungsvariable setzen (empfohlen)
export HAPPYHORSE_API_KEY="hh_xxxxxxxxxxxxxxxxxxxx"

# Option B: direkt in das Feld api_key des Nodes eintragen
# (Workflows nicht mit eingebettetem Schlüssel teilen)

Workflow wird geladen

Laden Sie unsere vorgefertigten Happyhorse-ComfyUI-Workflow-JSON-Dateien herunter und ziehen Sie sie direkt in Ihre ComfyUI-Arbeitsfläche, um sofort loszulegen.

Text-zu-Video — Basis

Einfacher Prompt-zu-Video-Workflow. Der beste Einstieg für die Happyhorse-ComfyUI-Videogenerierung.

happyhorse-t2v-basic.json
Text-zu-Video — Erweitert

Volle Parameterkontrolle: Auflösung, Bewegungsstärke, Guidance-Scale, Seed. Empfohlen für Happyhorse 1.0 ComfyUI-Power-User.

happyhorse-t2v-advanced.json
Bild-zu-Video

Laden Sie ein Referenzbild hoch und animieren Sie es mit der Bewegungsphysik von Happyhorse-1.0 über ComfyUI.

happyhorse-i2v.json

Ziehen Sie die heruntergeladene .json-Datei auf Ihre ComfyUI-Arbeitsfläche oder nutzen Sie Datei → Workflow öffnen. Die Happyhorse-Nodes werden automatisch geladen, wenn der Custom Node korrekt installiert ist.

API-Schlüssel einrichten

Der Happyhorse-ComfyUI-Node nutzt im Hintergrund die Happyhorse-REST-API. Dein API-Schlüssel authentifiziert jede Anfrage zur Videogenerierung.

Demnächst verfügbar

Happyhorse API — Start in Kürze

Die öffentliche Happyhorse-API befindet sich in den finalen Tests und wird in Kürze verfügbar sein. Trage dich in die Warteliste ein, um frühen Zugriff zu erhalten und als Erste*r deine ComfyUI-Workflows mit Happyhorse-1.0 zu verbinden.

In die Warteliste eintragen

1. Hol dir deinen kostenlosen API-Schlüssel

Registriere dich auf Happyhorselab.net — du erhältst bei der Anmeldung 10 kostenlose Compute-Credits, keine Kreditkarte erforderlich. Gehe zu Dashboard → API Keys → Create New Key.

2. Den Node konfigurieren

Der Node HappyhorseVideoGenerate hat ein Eingabefeld api_key. Du kannst den Schlüssel entweder direkt eingeben oder über den integrierten ComfyUI-Secret-Loader auf eine Umgebungsvariable verweisen.

json
# In deinem 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. Nutzung überwachen

Jede Generierung zieht Credits von deinem Guthaben ab. Deine verbleibenden Credits findest du unter Dashboard → Credits. Zusätzliche Compute-Pakete kannst du auf der Seite „Pricing“ kaufen — ohne Abo.

Beispielausgaben

Videos, die mit dem Happyhorse-ComfyUI-Custom-Node anhand der oben genannten Workflow-Dateien erzeugt wurden. Happyhorse-1.0 liefert zeitliche Konsistenz und cineastische Bewegungsphysik direkt in ComfyUI.

Happyhorse-1.0 output

Luftaufnahme einer Bergsequenz

cineastische Luftaufnahme schneebedeckter Berggipfel zur goldenen Stunde, sanftes Kameradriften, volumetrische Wolken

4KT2VLandschaft
Happyhorse-1.0 output

Charakter-Nahaufnahme

Porträt einer Frau in weichem Studiolicht, leichte Kopfbewegung, fotorealistische Hauttextur, geringe Tiefenschärfe

1080pT2VPorträt
Happyhorse-1.0 output

Bild-zu-Video-Demo

Produktbild, animiert mit sanfter Parallaxenbewegung und subtiler Veränderung des Umgebungslichts

720pI2VProdukt
Happyhorse-1.0 output

Abstrakte Bewegung

Flüssigfarben-Simulation in tiefem Blau und Gold, wirbelnde organische Muster, Makroobjektiv

1080pT2VAbstrakt

FAQ

Häufige Fragen zur Happyhorse-ComfyUI-Integration, Kompatibilität, API-Nutzung und Fehlerbehebung.

1

Welche ComfyUI-Versionen sind mit dem Happyhorse-Custom-Node kompatibel?

Der Happyhorse-ComfyUI-Custom-Node unterstützt ComfyUI v1.3.0 und neuer. Wir empfehlen, die neueste stabile Version zu verwenden. Wenn ein Versionsfehler auftritt, aktualisieren Sie ComfyUI in Ihrem ComfyUI-Verzeichnis per git pull und installieren Sie den Node anschließend mit pip install --upgrade comfyui-happyhorse neu.

2

Wie viele API-Credits verbraucht eine ComfyUI-Videogenerierung?

Standard-Generierungen in 720p verbrauchen 1 Credit pro 5 Sekunden Video. Hochskalierte Ausgaben in 1080p und 4K benötigen je nach Bewegungs-Komplexität und Nutzung der daVinci-MagiHuman-Physik-Engine 2–4 Credits. Den Verbrauch können Sie in Echtzeit im Dashboard unter → Credits einsehen.

3

Nach der Installation erhalte ich den Fehler „Node not found“ — wie behebe ich das?

Das bedeutet meist, dass ComfyUI nach der Installation nicht neu gestartet wurde. Schließen Sie ComfyUI vollständig und öffnen Sie es erneut. Falls der Fehler weiterhin auftritt, prüfen Sie den Installationspfad: Das Paket comfyui-happyhorse sollte in den site-packages Ihrer Python-Umgebung vorhanden sein. Führen Sie pip show comfyui-happyhorse zur Bestätigung aus. Prüfen Sie außerdem, ob Ihre Python-Version 3.10 oder neuer ist.

4

Kann ich den Happyhorse-ComfyUI-Node ohne Internetverbindung verwenden?

Nein — Happyhorse-1.0 läuft auf unserem Cloud-Inferenz-Cluster, daher benötigt der ComfyUI-Node eine aktive Internetverbindung, um Anfragen an die Happyhorse-API zu senden. Lokale Inferenz wird derzeit nicht unterstützt. Die Anfragen sind schlank (Text-Prompts oder Bild-Uploads) und die Ergebnisse werden effizient zurückgestreamt.

5

Gibt es einen vorgefertigten ComfyUI-Workflow für die Happyhorse-Image-to-Video-Generierung?

Ja. Laden Sie den Workflow happyhorse-i2v.json im Workflow-Abschnitt oben herunter. Öffnen Sie ihn in ComfyUI (auf die Canvas ziehen oder Datei → Workflow öffnen), verbinden Sie Ihr Referenzbild mit dem Image-Eingangs-Node, fügen Sie Ihren API-Key hinzu und starten Sie die Queue. Der Node übernimmt Codierung und Bewegungssynthese automatisch.

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.