Integracja Happyhorse-1.0 z ComfyUI
Oficjalny niestandardowy węzeł Happyhorse dla ComfyUI — podłącz najlepiej oceniany model wideo bezpośrednio do swojego workflow w ComfyUI. Zainstaluj w 3 krokach i zacznij generować kinowe wideo 4K.
Wymagania i instalacja
Uruchom niestandardowy węzeł Happyhorse dla ComfyUI w lokalnym lub chmurowym środowisku ComfyUI. Obsługuje ComfyUI v1.3+ z Pythonem 3.10+.
Wymagania
- ComfyUI v1.3.0 lub nowsze
- Python 3.10 lub nowszy
- Klucz API Happyhorse (bezpłatny po rejestracji)
- Dostęp do Internetu do wywołań API inferencji
Krok 1 — Zainstaluj niestandardowy węzeł przez pip
Otwórz terminal w katalogu głównym ComfyUI i uruchom:
pip install comfyui-happyhorseKrok 2 — Zrestartuj ComfyUI i załaduj węzeł
Po instalacji zrestartuj ComfyUI. W grafie węzłów kliknij prawym przyciskiem myszy → Add Node → Happyhorse → HappyhorseVideoGenerate. Węzeł pojawi się na liście w kategorii Happyhorse.
# Alternatywnie zainstaluj przez ComfyUI Manager:
# Otwórz ComfyUI Manager → Install Custom Nodes → wyszukaj "happyhorse"
# Kliknij Install → Zrestartuj ComfyUIKrok 3 — Wprowadź klucz API
W węźle HappyhorseVideoGenerate wklej klucz API do pola api_key lub ustaw go jako zmienną środowiskową:
# Opcja A: ustaw jako zmienną środowiskową (zalecane)
export HAPPYHORSE_API_KEY="hh_xxxxxxxxxxxxxxxxxxxx"
# Opcja B: wpisz bezpośrednio w polu api_key węzła
# (nie udostępniaj workflowów z osadzonym kluczem)Wczytywanie workflow
Pobierz nasze gotowe pliki JSON workflow Happyhorse dla ComfyUI i przeciągnij je bezpośrednio na płótno ComfyUI, aby od razu zacząć.
Prosty workflow prompt → wideo. Najlepszy punkt startowy do generowania wideo w Happyhorse w ComfyUI.
happyhorse-t2v-basic.jsonPełna kontrola parametrów: rozdzielczość, siła ruchu, skala prowadzenia, ziarno (seed). Polecane dla zaawansowanych użytkowników Happyhorse 1.0 w ComfyUI.
happyhorse-t2v-advanced.jsonPrześlij obraz referencyjny i animuj go za pomocą fizyki ruchu Happyhorse-1.0 przez ComfyUI.
happyhorse-i2v.jsonPrzeciągnij pobrany plik .json na płótno ComfyUI lub użyj Plik → Otwórz workflow. Węzły Happyhorse załadują się automatycznie, jeśli węzeł niestandardowy został poprawnie zainstalowany.
Konfiguracja klucza API
Węzeł Happyhorse dla ComfyUI korzysta w tle z REST API Happyhorse. Twój klucz API uwierzytelnia każde żądanie generowania wideo.
Happyhorse API — już wkrótce start
Publiczne API Happyhorse jest na etapie końcowych testów i będzie dostępne już niebawem. Dołącz do listy oczekujących, aby uzyskać wcześniejszy dostęp i jako pierwszy połączyć swoje workflowy ComfyUI z Happyhorse-1.0.
1. Odbierz swój darmowy klucz API
Zarejestruj się na Happyhorselab.net — po rejestracji otrzymasz 10 darmowych kredytów obliczeniowych, bez konieczności podawania karty. Przejdź do Dashboard → API Keys → Create New Key.
2. Skonfiguruj węzeł
Węzeł HappyhorseVideoGenerate ma pole wejściowe api_key. Możesz wpisać klucz bezpośrednio albo odwołać się do zmiennej środowiskowej, korzystając z wbudowanego w ComfyUI mechanizmu ładowania sekretów.
# 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. Monitoruj wykorzystanie
Każde generowanie odejmuje kredyty z Twojego salda. Pozostałe kredyty sprawdzisz w Dashboard → Credits. Dodatkowe pakiety mocy obliczeniowej kupisz na stronie Pricing — bez konieczności subskrypcji.
Przykładowe wyniki
Filmy wygenerowane za pomocą niestandardowego węzła Happyhorse dla ComfyUI z użyciem powyższych plików workflow. Happyhorse-1.0 zapewnia spójność czasową oraz filmową fizykę ruchu bezpośrednio w ComfyUI.
Ujęcie lotnicze gór
“kinematograficzne ujęcie lotnicze ośnieżonych górskich szczytów podczas złotej godziny, płynny dryf kamery, wolumetryczne chmury”
Zbliżenie postaci
“portret kobiety w miękkim świetle studyjnym, lekkie odwrócenie głowy, fotorealistyczna tekstura skóry, płytka głębia ostrości”
Demo: obraz na wideo
“obraz produktu ożywiony delikatnym ruchem paralaksy i subtelną zmianą oświetlenia otoczenia”
Abstrakcyjny ruch
“symulacja płynnej farby w głębokim błękicie i złocie, wirujące organiczne wzory, obiektyw makro”
FAQ
Najczęstsze pytania dotyczące integracji Happyhorse z ComfyUI, zgodności, korzystania z API oraz rozwiązywania problemów.
Które wersje ComfyUI są kompatybilne z niestandardowym węzłem Happyhorse?
Niestandardowy węzeł Happyhorse dla ComfyUI obsługuje ComfyUI v1.3.0 i nowsze. Zalecamy korzystanie z najnowszego stabilnego wydania. Jeśli napotkasz błąd wersji, zaktualizuj ComfyUI poleceniem git pull w katalogu ComfyUI i przeinstaluj węzeł poleceniem pip install --upgrade comfyui-happyhorse.
Ile kredytów API zużywa jedno generowanie wideo w ComfyUI?
Standardowe generacje 720p zużywają 1 kredyt na każde 5 sekund wideo. Wyjścia 1080p oraz przeskalowane do 4K wymagają 2–4 kredytów w zależności od złożoności ruchu i użycia silnika fizyki daVinci-MagiHuman. Zużycie możesz monitorować w czasie rzeczywistym w Panelu → Kredyty.
Po instalacji dostaję błąd „Node not found” — jak to naprawić?
Zwykle oznacza to, że ComfyUI nie zostało zrestartowane po instalacji. Całkowicie zamknij i uruchom ponownie ComfyUI. Jeśli błąd nie ustępuje, sprawdź ścieżkę instalacji: pakiet comfyui-happyhorse powinien znajdować się w site-packages Twojego środowiska Pythona. Uruchom pip show comfyui-happyhorse, aby to potwierdzić. Sprawdź też, czy używasz Pythona w wersji 3.10 lub nowszej.
Czy mogę używać węzła Happyhorse w ComfyUI bez połączenia z internetem?
Nie — Happyhorse-1.0 działa na naszym chmurowym klastrze inferencyjnym, więc węzeł ComfyUI wymaga aktywnego połączenia z internetem, aby wysyłać żądania do API Happyhorse. Lokalna inferencja nie jest obecnie obsługiwana. Żądania są lekkie (prompty tekstowe lub przesyłane obrazy), a wyniki są efektywnie strumieniowane z powrotem.
Czy istnieje gotowy workflow ComfyUI do generowania obraz→wideo w Happyhorse?
Tak. Pobierz workflow happyhorse-i2v.json z sekcji Workflow powyżej. Wczytaj go w ComfyUI (przeciągnij na płótno lub Plik → Otwórz workflow), podłącz obraz referencyjny do węzła wejściowego Image, dodaj klucz API i dodaj prompt do kolejki. Węzeł automatycznie zajmuje się kodowaniem i syntezą ruchu.
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.