Інтеграція Happyhorse-1.0 для ComfyUI
Офіційний користувацький вузол Happyhorse для ComfyUI — підключайте відеомодель №1 безпосередньо до свого робочого процесу ComfyUI. Встановіть за 3 кроки та почніть генерувати кінематографічне 4K-відео.
Вимоги та встановлення
Запустіть кастомний вузол Happyhorse для ComfyUI у своєму локальному або хмарному середовищі ComfyUI. Підтримується ComfyUI v1.3+ з Python 3.10+.
Вимоги
- ComfyUI v1.3.0 або новіше
- Python 3.10 або новіше
- API-ключ Happyhorse (безкоштовно під час реєстрації)
- Доступ до інтернету для API-викликів інференсу
Крок 1 — Встановіть кастомний вузол через pip
Відкрийте термінал у кореневій директорії ComfyUI та виконайте:
pip install comfyui-happyhorseКрок 2 — Перезапустіть ComfyUI та завантажте вузол
Після встановлення перезапустіть ComfyUI. У графі вузлів клацніть правою кнопкою миші → Add Node → Happyhorse → HappyhorseVideoGenerate. Вузол з’явиться у вашій палітрі в категорії Happyhorse.
# Або встановіть через ComfyUI Manager:
# Відкрийте ComfyUI Manager → Install Custom Nodes → знайдіть "happyhorse"
# Натисніть Install → Перезапустіть ComfyUIКрок 3 — Введіть свій API-ключ
У вузлі HappyhorseVideoGenerate вставте свій API-ключ у поле api_key або задайте його як змінну середовища:
# Варіант A: задати як змінну середовища (рекомендовано)
export HAPPYHORSE_API_KEY="hh_xxxxxxxxxxxxxxxxxxxx"
# Варіант B: ввести напряму в поле api_key вузла
# (не поширюйте workflow із вбудованим ключем)Завантаження робочого процесу
Завантажте наші готові JSON-файли робочих процесів Happyhorse для ComfyUI та перетягніть їх прямо на полотно ComfyUI, щоб миттєво розпочати роботу.
Простий робочий процес «запит → відео». Найкраща стартова точка для генерації відео в happyhorse comfyui.
happyhorse-t2v-basic.jsonПовний контроль параметрів: роздільна здатність, інтенсивність руху, шкала наведення, seed. Рекомендовано для досвідчених користувачів happy horse 1.0 comfyui.
happyhorse-t2v-advanced.jsonЗавантажте референсне зображення та анімуйте його за допомогою фізики руху Happyhorse-1.0 через ComfyUI.
happyhorse-i2v.jsonПеретягніть завантажений файл .json на полотно ComfyUI або скористайтеся File → Open Workflow. Вузли Happyhorse завантажаться автоматично, якщо кастомний вузол встановлено правильно.
Налаштування API-ключа
Вузол Happyhorse для ComfyUI використовує Happyhorse REST API «під капотом». Ваш API-ключ автентифікує кожен запит на генерацію відео.
Happyhorse API — запуск незабаром
Публічний API Happyhorse проходить фінальне тестування та буде доступний уже зовсім скоро. Приєднуйтеся до списку очікування, щоб отримати ранній доступ і першими під’єднати свої робочі процеси ComfyUI до Happyhorse-1.0.
1. Отримайте безкоштовний API-ключ
Зареєструйтеся на Happyhorselab.net — під час реєстрації ви отримуєте 10 безкоштовних обчислювальних кредитів, банківська картка не потрібна. Перейдіть до Dashboard → API Keys → Create New Key.
2. Налаштуйте вузол
Вузол HappyhorseVideoGenerate має поле введення api_key. Ви можете або ввести ключ безпосередньо, або послатися на змінну середовища за допомогою вбудованого завантажувача секретів ComfyUI.
# 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. Відстежуйте використання
Кожна генерація списує кредити з вашого балансу. Перевіряйте залишок кредитів у Dashboard → Credits. Додаткові обчислювальні пакети можна придбати на сторінці Pricing без необхідності підписки.
Приклади результатів
Відео, згенеровані за допомогою кастомного вузла Happyhorse для ComfyUI з використанням наведених вище файлів робочих процесів. Happyhorse-1.0 забезпечує часову узгодженість і кінематографічну фізику руху безпосередньо в ComfyUI.
Аерозйомка гірського пейзажу
“кінематографічний аерокадр засніжених гірських вершин у золоту годину, плавний дрейф камери, об’ємні хмари”
Крупний план персонажа
“портрет жінки в м’якому студійному світлі, легкий поворот голови, фотореалістична текстура шкіри, мала глибина різкості”
Демо зображення-в-відео
“анімація зображення продукту з легким паралакс-рухом і плавною зміною навколишнього освітлення”
Абстрактний рух
“симуляція рідкої фарби в насичених синіх і золотих тонах, закручені органічні візерунки, макрооб’єктив”
FAQ
Поширені запитання про інтеграцію Happyhorse з ComfyUI, сумісність, використання API та усунення несправностей.
Які версії ComfyUI сумісні з кастомним вузлом Happyhorse?
Кастомний вузол Happyhorse для ComfyUI підтримує ComfyUI v1.3.0 і новіші. Рекомендуємо використовувати останній стабільний реліз. Якщо виникає помилка версії, оновіть ComfyUI командою git pull у каталозі ComfyUI та перевстановіть вузол командою pip install --upgrade comfyui-happyhorse.
Скільки API-кредитів споживає одна генерація відео в ComfyUI?
Стандартні генерації у 720p споживають 1 кредит за кожні 5 секунд відео. Вивід у 1080p та 4K після апскейлу потребує 2–4 кредити залежно від складності руху та використання фізичного рушія daVinci-MagiHuman. Використання можна відстежувати в реальному часі на сторінці Dashboard → Credits.
Після встановлення з’являється помилка «Node not found» — як це виправити?
Зазвичай це означає, що ComfyUI не було перезапущено після встановлення. Повністю закрийте й знову відкрийте ComfyUI. Якщо помилка не зникає, перевірте шлях встановлення: пакет comfyui-happyhorse має з’явитися в site-packages вашого Python-оточення. Для підтвердження виконайте pip show comfyui-happyhorse. Також переконайтеся, що версія Python — 3.10 або новіша.
Чи можна використовувати вузол Happyhorse для ComfyUI без підключення до інтернету?
Ні — Happyhorse-1.0 працює на нашому хмарному кластері інференсу, тож вузлу ComfyUI потрібне активне інтернет-з’єднання для надсилання запитів до Happyhorse API. Локальна інференція наразі не підтримується. Запити є «легкими» (текстові промпти або завантаження зображень), а результати ефективно повертаються у потоковому режимі.
Чи є готовий workflow для ComfyUI для генерації відео з зображення (image-to-video) у Happyhorse?
Так. Завантажте workflow happyhorse-i2v.json з розділу Workflow вище. Відкрийте його в ComfyUI (перетягніть на полотно або File → Open Workflow), під’єднайте референсне зображення до вузла входу Image, додайте свій API-ключ і поставте промпт у чергу. Вузол автоматично виконує кодування та синтез руху.
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.