Happyhorse-1.0 API 액세스
사용한 만큼 결제 · 구독 없음 · 내 앱에서 사용
Happyhorse-1.0 REST API가 곧 출시됩니다. 현재 Happyhorse API 직접 액세스는 비공개 프리뷰로 제공되지만, 지금은 웹에서 바로 영상을 생성할 수 있습니다 — 동일한 모델, 동일한 품질, 사용한 만큼만 결제하세요.
Happyhorse-1.0 온라인 사용 — API 키 불필요
Happyhorse API 키 시스템은 현재 개발 중이지만, 모델은 오늘 바로 사용 가능합니다. 크레딧을 구매해 사이트에서 4K 영상을 생성하고 다운로드하세요 — 완전한 상업용 라이선스가 포함됩니다. REST API가 출시되면 보유 크레딧은 자동으로 이관됩니다.
크레딧 구매
1회 결제, 구독 없음. 크레딧은 웹 앱, 향후 Happyhorse API 호출, 그리고 ComfyUI 노드에서 공통으로 사용됩니다.
영상 생성
Happyhorse-1.0 Lab에 프롬프트를 입력하세요. REST API를 구동할 것과 동일한 모델 — daVinci-MagiHuman 아키텍처, 네이티브 4K.
다운로드 & 출시
MP4 출력과 100% 상업적 IP 소유권 제공. Happyhorse API 엔드포인트가 공개되면 키를 연결해 동일한 워크플로를 자동화할 수 있습니다.
API 작동 방식
Happyhorse-1.0 REST API는 간단한 비동기 요청-폴링 모델을 따릅니다. happyhorse API 키로 인증한 뒤 작업을 제출하고, 준비가 되면 결과를 가져오세요. 아래는 happyhorse-1.0 API 연동 미리보기입니다.
인증
Authorization 헤더에 happyhorse API 키를 포함하세요. 키는 워크스페이스별 범위로 적용되며, 요금제별로 레이트 리밋이 적용됩니다.
작업 제출
프롬프트와 파라미터를 /v1/generate 엔드포인트로 POST하세요. Happyhorse API 엔드포인트는 즉시 job_id를 반환합니다.
상태 폴링
진행 상황을 확인하려면 GET /v1/jobs/{job_id}를 호출하세요. status가 completed가 되면, 응답에 24시간 동안 유효한 서명된 비디오 URL이 포함됩니다.
다운로드 및 사용
MP4 결과물을 다운로드하거나 바로 스트리밍해서 사용하세요. 크레딧은 생성이 성공했을 때만 차감되며, 실패한 작업에는 과금되지 않습니다.
curl — 비디오 생성 작업 제출
curl -X POST https://api.happyhorselab.net/v1/generate \
-H "Authorization: Bearer hh_xxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A lone astronaut walks across a red desert at golden hour, cinematic 4K",
"resolution": "4K",
"duration": 8,
"motion_strength": 0.7,
"fps": 24
}'Python — 전체 연동 예제
import requests
import time
API_KEY = "hh_xxxxxxxxxxxxxxxxxxxx"
BASE_URL = "https://api.happyhorselab.net/v1"
# Submit generation job
response = requests.post(
f"{BASE_URL}/generate",
headers={"Authorization": f"Bearer {API_KEY}"},
json={
"prompt": "A lone astronaut walks across a red desert at golden hour",
"resolution": "4K",
"duration": 8,
"motion_strength": 0.7,
"fps": 24,
},
)
job_id = response.json()["job_id"]
# Poll until complete
while True:
status = requests.get(
f"{BASE_URL}/jobs/{job_id}",
headers={"Authorization": f"Bearer {API_KEY}"},
).json()
if status["status"] == "completed":
print("Video URL:", status["output_url"])
break
elif status["status"] == "failed":
print("Generation failed:", status["error"])
break
time.sleep(5)요금제 및 크레딧
Happyhorse API 접근은 사이트와 동일한 크레딧 시스템으로 운영됩니다. 별도의 구독이나 좌석(Seat) 요금은 없습니다. 오늘 구매한 크레딧은 웹 앱에서 사용 가능하며, 출시 시 Happyhorse API의 사용량 기반(Pay-as-you-go) 모델로 그대로 이어집니다.
스탠다드
영상당 약 ~$0.10부터
1080p, 최대 8초, 일반 대기열. Happy Horse AI Video API 프로토타이핑 및 평가에 적합합니다.
프로
영상당 약 ~$0.25부터
네이티브 4K, 최대 16초, 우선 대기열. 대규모에서의 사용량 기반(Pay-as-you-go) 모델로 프로덕션 워크로드에 맞춰 설계되었습니다.
엔터프라이즈
맞춤 요금
대량 사용 할인, SLA 보장, 전용 엔드포인트, 팀 간 Happyhorse API 키 관리.
사이트에서 구매한 크레딧은 향후 API 크레딧과 완전히 호환되어 자유롭게 사용할 수 있습니다. 별도의 Happyhorse API 요금제 구간은 없으며, 생성한 만큼만 결제합니다.
계정이 활성 상태인 동안 크레딧은 만료되지 않습니다.
API 엔드포인트(프리뷰)
Happyhorse-1.0 REST API는 영상 생성 및 작업 관리를 위한 핵심 엔드포인트 세트를 제공합니다. Happyhorse-1.0 API 전체 문서는 출시 시 공개됩니다.
/v1/generate텍스트-투-비디오 또는 이미지-투-비디오 생성 작업을 제출합니다. 폴링에 사용할 job_id를 반환합니다.
| Parameter | Type | Required | Description |
|---|---|---|---|
| prompt | string | required | 영상에 대한 텍스트 설명입니다. |
| resolution | string | optional | "1080p"(기본값) 또는 "4K". 4K는 Pro 크레딧이 필요합니다. |
| duration | integer | optional | 영상 길이(초)입니다. 범위: 2–16. 기본값: 8. |
| motion_strength | float | optional | 모션 강도 0.0–1.0. 기본값: 0.6. |
| fps | integer | optional | 초당 프레임 수(FPS): 24 또는 30. 기본값: 24. |
| seed | integer | optional | 재현성을 위한 시드 값입니다. 무작위로 하려면 생략하세요. |
/v1/jobs/{job_id}생성 작업의 상태를 폴링합니다. 완료 시 status, progress, output_url을 반환합니다.
/v1/credits남은 happyhorse API 크레딧 잔액과 사용 내역을 확인합니다.
/v1/models사용 가능한 모델과 각 파라미터 범위를 나열합니다. 현재는 happyhorse-1.0만 제공합니다.
응답 예시 — 작업 완료
{
"job_id": "job_01HZ9X3K7VQWPN8S4TYJB6MDE",
"status": "completed",
"model": "happyhorse-1.0",
"created_at": "2025-06-01T14:22:10Z",
"completed_at": "2025-06-01T14:23:48Z",
"credits_used": 25,
"output_url": "https://cdn.happyhorselab.net/out/job_01HZ9X3K7VQWPN8S4TYJB6MDE.mp4",
"output_url_expires_at": "2025-06-02T14:23:48Z",
"metadata": {
"resolution": "4K",
"duration": 8,
"fps": 24,
"motion_strength": 0.7
}
}자주 묻는 질문(FAQ)
Happyhorse API 액세스, 크레딧, 통합에 대한 자주 묻는 질문입니다.
Happyhorse API 키는 어떻게 받나요?
Happyhorse API 키 시스템은 현재 비공개 프리뷰 단계입니다. 그동안 happyhorselab.net 웹 앱을 사용해 주세요 — 동일한 모델, 동일한 품질입니다. 요금제 페이지에서 크레딧을 구매하면 바로 생성(Generation)을 시작할 수 있습니다. 직접 액세스가 출시되면 대시보드에서 API 키를 사용할 수 있게 됩니다.
Happyhorse-1.0 API는 ComfyUI와 호환되나요?
네. 공식 Happyhorse ComfyUI 커스텀 노드는 내부적으로 동일한 REST API를 사용합니다. 웹 앱에서 구매한 크레딧은 ComfyUI 통합에서도 동일하게 사용할 수 있습니다. 설정 방법은 /comfyui 가이드를 참고해 주세요.
요청 제한(레이트 리밋)은 어떻게 되나요?
레이트 리밋은 크레딧 플랜에 따라 달라집니다. 표준 액세스는 동시 작업 10개와 분당 500회 요청부터 시작합니다. 엔터프라이즈 플랜은 맞춤 제한, 전용 엔드포인트, SLA 보장을 제공하며, Happyhorse API 엔터프라이즈 요금은 문의해 주세요.
엔터프라이즈 또는 화이트라벨 API 액세스가 가능한가요?
네. 엔터프라이즈 고객은 전용 추론 엔드포인트, 대용량 크레딧 패키지, 맞춤형 SLA, 비공개 모델 파인튜닝을 요청할 수 있습니다. 요금제 페이지를 통해 문의하시면 맞춤 플랜으로 안내해 드립니다.
Happyhorse API 크레딧은 만료되나요?
happyhorselab.net에서 구매한 크레딧은 계정이 활성 상태인 한 만료되지 않습니다(365일 내 1회 이상 로그인 필요). 웹 앱, API, ComfyUI 노드 중 어떤 방식으로 사용하든 동일한 Happyhorse API 크레딧 정책이 적용됩니다.
Happyhorse API는 어떤 프로그래밍 언어를 지원하나요?
Happyhorse-1.0 REST API는 표준 HTTP API이므로 어떤 언어든 사용할 수 있습니다: Python, Node.js, Go, Ruby, PHP, Java, Rust 등. 공식 Python 및 TypeScript SDK는 출시와 함께 제공할 예정입니다. 그전에는 Authorization 헤더에 Happyhorse API 키를 넣고 원하는 HTTP 클라이언트를 사용해 주세요.
오늘부터 #1 비디오 모델로 제작하세요
API를 기다리지 마세요. 지금 바로 Happyhorse-1.0을 온라인에서 사용하고, 크레딧 단위로 결제하세요. REST API가 출시되면 잔액은 자동으로 이월됩니다.
