Tích hợp Happyhorse-1.0 cho ComfyUI
Custom node ComfyUI chính thức của Happyhorse — kết nối trực tiếp mô hình video xếp hạng #1 vào workflow ComfyUI của bạn. Cài đặt chỉ trong 3 bước và bắt đầu tạo video 4K điện ảnh.
Yêu cầu & Cài đặt
Thiết lập và chạy custom node Happyhorse cho ComfyUI trên môi trường ComfyUI cục bộ hoặc đám mây của bạn. Hỗ trợ ComfyUI v1.3+ với Python 3.10+.
Yêu cầu
- ComfyUI v1.3.0 trở lên
- Python 3.10 trở lên
- Khóa API Happyhorse (miễn phí khi đăng ký)
- Có kết nối Internet để gọi API suy luận
Bước 1 — Cài đặt custom node bằng pip
Mở terminal tại thư mục gốc của ComfyUI và chạy:
pip install comfyui-happyhorseBước 2 — Khởi động lại ComfyUI và nạp node
Sau khi cài đặt, hãy khởi động lại ComfyUI. Trong node graph, nhấp chuột phải → Add Node → Happyhorse → HappyhorseVideoGenerate. Node sẽ xuất hiện trong bảng node của bạn dưới danh mục Happyhorse.
# Ngoài ra, có thể cài qua ComfyUI Manager:
# Mở ComfyUI Manager → Install Custom Nodes → tìm "happyhorse"
# Nhấn Install → Khởi động lại ComfyUIBước 3 — Nhập khóa API của bạn
Trong node HappyhorseVideoGenerate, dán khóa API vào trường api_key, hoặc đặt dưới dạng biến môi trường:
# Cách A: đặt dưới dạng biến môi trường (khuyến nghị)
export HAPPYHORSE_API_KEY="hh_xxxxxxxxxxxxxxxxxxxx"
# Cách B: nhập trực tiếp vào trường api_key của node
# (không chia sẻ workflow khi có nhúng khóa)Tải Workflow
Tải các tệp JSON workflow Happyhorse ComfyUI dựng sẵn của chúng tôi và kéo thả trực tiếp vào canvas ComfyUI để bắt đầu ngay lập tức.
Workflow tạo video từ prompt đơn giản. Điểm khởi đầu tốt nhất để tạo video với happyhorse trên ComfyUI.
happyhorse-t2v-basic.jsonKiểm soát đầy đủ tham số: độ phân giải, cường độ chuyển động, thang hướng dẫn, seed. Khuyến nghị cho power user happy horse 1.0 trên ComfyUI.
happyhorse-t2v-advanced.jsonTải lên một ảnh tham chiếu và tạo hoạt ảnh với vật lý chuyển động Happyhorse-1.0 thông qua ComfyUI.
happyhorse-i2v.jsonKéo thả tệp .json đã tải xuống vào canvas ComfyUI, hoặc dùng File → Open Workflow. Các node Happyhorse sẽ tự động được tải nếu custom node đã được cài đặt đúng cách.
Thiết lập API Key
Node ComfyUI của Happyhorse sử dụng REST API của Happyhorse ở phía sau. API key của bạn sẽ xác thực cho từng yêu cầu tạo video.
Happyhorse API — Sắp ra mắt
API công khai của Happyhorse đang ở giai đoạn kiểm thử cuối cùng và sẽ sớm được mở. Hãy tham gia danh sách chờ để nhận quyền truy cập sớm và là người đầu tiên kết nối các workflow ComfyUI của bạn với Happyhorse-1.0.
1. Nhận API key miễn phí
Đăng ký tại Happyhorselab.net — bạn sẽ nhận 10 tín dụng compute miễn phí khi đăng ký, không cần thẻ tín dụng. Vào Dashboard → API Keys → Create New Key.
2. Cấu hình node
Node HappyhorseVideoGenerate có trường nhập api_key. Bạn có thể nhập key trực tiếp hoặc tham chiếu một biến môi trường bằng trình tải secret tích hợp sẵn của ComfyUI.
# Trong node workflow ComfyUI của bạn:
{
"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. Theo dõi mức sử dụng
Mỗi lần tạo sẽ trừ tín dụng khỏi số dư của bạn. Kiểm tra số tín dụng còn lại tại Dashboard → Credits. Mua thêm các gói compute trên trang Pricing, không cần đăng ký thuê bao.
Kết quả mẫu
Các video được tạo bằng node tuỳ chỉnh Happyhorse ComfyUI với các tệp workflow ở trên. Happyhorse-1.0 mang đến tính nhất quán theo thời gian và chuyển động mang chất điện ảnh ngay trong ComfyUI.
Chuỗi cảnh núi từ trên cao
“cảnh quay điện ảnh từ trên không của các đỉnh núi phủ tuyết vào giờ vàng, camera trôi mượt, mây thể tích”
Cận cảnh nhân vật
“chân dung một người phụ nữ dưới ánh sáng studio mềm, hơi quay đầu, kết cấu da siêu thực, độ sâu trường ảnh nông”
Demo chuyển ảnh sang video
“ảnh sản phẩm được tạo chuyển động parallax nhẹ và thay đổi ánh sáng môi trường”
Chuyển động trừu tượng
“mô phỏng sơn lỏng xanh đậm và vàng, các hoạ tiết hữu cơ xoáy lượn, ống kính macro”
Câu hỏi thường gặp (FAQ)
Các câu hỏi phổ biến về tích hợp Happyhorse với ComfyUI, khả năng tương thích, cách dùng API và khắc phục sự cố.
Những phiên bản ComfyUI nào tương thích với custom node Happyhorse?
Custom node Happyhorse cho ComfyUI hỗ trợ ComfyUI v1.3.0 trở lên. Chúng tôi khuyến nghị dùng bản phát hành ổn định mới nhất. Nếu bạn gặp lỗi phiên bản, hãy nâng cấp ComfyUI bằng git pull trong thư mục ComfyUI và cài lại node bằng pip install --upgrade comfyui-happyhorse.
Một lần tạo video bằng ComfyUI sẽ tốn bao nhiêu credit API?
Các lần tạo chuẩn 720p tiêu tốn 1 credit cho mỗi 5 giây video. Đầu ra 1080p và 4K (đã upscale) cần 2–4 credit tùy theo độ phức tạp chuyển động và việc sử dụng engine vật lý daVinci-MagiHuman. Bạn có thể theo dõi mức sử dụng theo thời gian thực tại Dashboard → Credits.
Sau khi cài đặt tôi gặp lỗi 'Node not found' — phải sửa thế nào?
Điều này thường xảy ra khi ComfyUI chưa được khởi động lại sau khi cài đặt. Hãy đóng hoàn toàn và mở lại ComfyUI. Nếu vẫn còn lỗi, hãy kiểm tra đường dẫn cài đặt: gói comfyui-happyhorse phải xuất hiện trong site-packages của môi trường Python. Chạy pip show comfyui-happyhorse để xác nhận. Đồng thời kiểm tra phiên bản Python của bạn là 3.10 trở lên.
Tôi có thể dùng node Happyhorse cho ComfyUI khi không có internet không?
Không — Happyhorse-1.0 chạy trên cụm suy luận (inference) đám mây của chúng tôi, vì vậy node ComfyUI cần có kết nối internet để gửi yêu cầu đến Happyhorse API. Hiện chưa hỗ trợ suy luận cục bộ (local inference). Các yêu cầu khá nhẹ (prompt văn bản hoặc tải ảnh lên) và kết quả được truyền về theo dạng stream một cách hiệu quả.
Có workflow ComfyUI dựng sẵn cho tạo video từ ảnh (image-to-video) bằng Happyhorse không?
Có. Tải workflow happyhorse-i2v.json ở mục Workflow phía trên. Mở trong ComfyUI (kéo thả lên canvas hoặc File → Open Workflow), nối ảnh tham chiếu của bạn vào node đầu vào Image, thêm API key và đưa prompt vào hàng đợi. Node sẽ tự động xử lý mã hóa và tổng hợp chuyển động.
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.