Happyhorse-1.0 ComfyUI 통합
공식 Happyhorse ComfyUI 커스텀 노드 — 1위 비디오 모델을 ComfyUI 워크플로에 바로 연결하세요. 3단계로 설치하고 시네마틱 4K 영상을 생성해 보세요.
요구 사항 및 설치
로컬 또는 클라우드 ComfyUI 환경에서 Happyhorse ComfyUI 커스텀 노드를 실행하세요. Python 3.10+ 기반의 ComfyUI v1.3+를 지원합니다.
요구 사항
- ComfyUI v1.3.0 이상
- Python 3.10 이상
- Happyhorse API 키(가입 시 무료 발급)
- 추론 API 호출을 위한 인터넷 연결
1단계 — pip로 커스텀 노드 설치
ComfyUI 루트 디렉터리에서 터미널을 열고 다음을 실행하세요:
pip install comfyui-happyhorse2단계 — ComfyUI 재시작 및 노드 로드
설치 후 ComfyUI를 재시작하세요. 노드 그래프에서 마우스 오른쪽 클릭 → Add Node → Happyhorse → HappyhorseVideoGenerate를 선택하면 됩니다. 해당 노드는 팔레트에서 Happyhorse 카테고리 아래에 표시됩니다.
# 또는 ComfyUI Manager로 설치할 수도 있습니다:
# ComfyUI Manager 열기 → Install Custom Nodes → "happyhorse" 검색
# Install 클릭 → ComfyUI 재시작3단계 — API 키 입력
HappyhorseVideoGenerate 노드에서 api_key 필드에 API 키를 붙여넣거나, 환경 변수로 설정하세요:
# 옵션 A: 환경 변수로 설정(권장)
export HAPPYHORSE_API_KEY="hh_xxxxxxxxxxxxxxxxxxxx"
# 옵션 B: 노드의 api_key 필드에 직접 입력
# (키가 포함된 워크플로는 공유하지 마세요)워크플로 불러오기
미리 제작된 Happyhorse ComfyUI 워크플로 JSON 파일을 다운로드한 뒤 ComfyUI 캔버스로 바로 드래그하여 즉시 시작하세요.
해상도, 모션 강도, 가이던스 스케일, 시드 등 전체 파라미터를 제어합니다. Happyhorse 1.0 ComfyUI 고급 사용자에게 권장합니다.
happyhorse-t2v-advanced.json다운로드한 .json 파일을 ComfyUI 캔버스로 드래그하거나 파일 → 워크플로 열기를 사용하세요. 커스텀 노드가 올바르게 설치되어 있다면 Happyhorse 노드가 자동으로 로드됩니다.
API 키 설정
Happyhorse ComfyUI 노드는 내부적으로 Happyhorse REST API를 사용합니다. API 키는 각 비디오 생성 요청을 인증합니다.
Happyhorse API — 곧 출시됩니다
Happyhorse 공개 API는 최종 테스트 단계에 있으며 곧 제공될 예정입니다. 대기자 명단에 등록해 얼리 액세스를 받고, ComfyUI 워크플로를 Happyhorse-1.0에 가장 먼저 연결해 보세요.
1. 무료 API 키 받기
Happyhorselab.net에서 가입하세요 — 가입 시 신용카드 없이 무료 컴퓨트 크레딧 10이 지급됩니다. 대시보드 → 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. 사용량 모니터링
생성할 때마다 잔액에서 크레딧이 차감됩니다. 대시보드 → Credits에서 남은 크레딧을 확인하세요. 구독 없이도 Pricing 페이지에서 추가 컴퓨트 팩을 구매할 수 있습니다.
예시 결과물
위의 워크플로 파일을 사용해 Happyhorse ComfyUI 커스텀 노드로 생성한 영상입니다. Happyhorse-1.0은 ComfyUI 안에서 바로 시간적 일관성과 시네마틱한 모션 물리를 제공합니다.
항공 산악 시퀀스
“골든아워의 눈 덮인 산봉우리를 담은 시네마틱 항공 샷, 부드러운 카메라 드리프트, 볼류메트릭 구름”
캐릭터 클로즈업
“부드러운 스튜디오 조명 아래 여성의 인물 사진, 살짝 고개를 돌리는 동작, 사실적인 피부 텍스처, 얕은 피사계 심도”
이미지-투-비디오 데모
“제품 이미지를 은은한 패럴랙스 모션과 주변광 변화로 애니메이션화”
추상 모션
“짙은 블루와 골드 톤의 유체 페인트 시뮬레이션, 소용돌이치는 유기적 패턴, 매크로 렌즈”
자주 묻는 질문(FAQ)
Happyhorse ComfyUI 통합, 호환성, API 사용 방법 및 문제 해결에 관한 자주 묻는 질문입니다.
Happyhorse 커스텀 노드와 호환되는 ComfyUI 버전은 무엇인가요?
Happyhorse ComfyUI 커스텀 노드는 ComfyUI v1.3.0 이상을 지원합니다. 최신 안정 버전을 사용하시는 것을 권장합니다. 버전 오류가 발생하면 ComfyUI 디렉터리에서 git pull로 ComfyUI를 업데이트한 뒤, pip install --upgrade comfyui-happyhorse로 노드를 다시 설치하세요.
ComfyUI에서 동영상 1회 생성 시 API 크레딧은 얼마나 소모되나요?
표준 720p 생성은 동영상 5초당 1크레딧을 소모합니다. 1080p 및 4K 업스케일 출력은 모션 복잡도와 daVinci-MagiHuman 물리 엔진 사용 여부에 따라 2~4크레딧이 필요합니다. 사용량은 대시보드 → 크레딧 페이지에서 실시간으로 확인할 수 있습니다.
설치 후 'Node not found' 오류가 뜨는데, 어떻게 해결하나요?
대부분 설치 후 ComfyUI를 재시작하지 않아 발생합니다. ComfyUI를 완전히 종료한 뒤 다시 실행하세요. 문제가 계속되면 설치 경로를 확인하세요. comfyui-happyhorse 패키지가 사용 중인 Python 환경의 site-packages 아래에 있어야 합니다. 확인을 위해 pip show comfyui-happyhorse를 실행하세요. 또한 Python 버전이 3.10 이상인지 확인해 주세요.
인터넷 연결 없이도 Happyhorse ComfyUI 노드를 사용할 수 있나요?
아니요. Happyhorse-1.0은 클라우드 추론 클러스터에서 실행되므로, ComfyUI 노드는 Happyhorse API로 요청을 보내기 위해 활성 인터넷 연결이 필요합니다. 로컬 추론은 현재 지원되지 않습니다. 요청은 가볍게 전송되며(텍스트 프롬프트 또는 이미지 업로드), 결과는 효율적으로 스트리밍되어 돌아옵니다.
Happyhorse 이미지-투-비디오 생성을 위한 미리 구성된 ComfyUI 워크플로가 있나요?
네. 위의 워크플로(Workflow) 섹션에서 happyhorse-i2v.json 워크플로를 다운로드하세요. 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.