LogoHappyHorse AI

HappyHorse API 문서

애플리케이션에 HappyHorse 1.0 동영상 생성 API를 통합하는 전체 가이드입니다.

API v1.0 Base URL: https://happyhorse.app

빠른 시작

bash
curl -X POST 'https://happyhorse.app/api/generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "happyhorse-1.0/video",
    "prompt": "A cinematic shot of mountains at sunrise",
    "mode": "pro",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

인증

모든 API 요청에는 Authorization 헤더에 Bearer 토큰이 필요합니다.

API 키 받기: 대시보드의 API Keys 페이지에서 API 키를 확인할 수 있습니다. → API 키 받기

http
Authorization: Bearer YOUR_API_KEY

사용 가능한 모델

HappyHorse 1.0

HappyHorse 1.0

HappyHorse 기반 고품질 AI 동영상 생성

유형설명길이크레딧
pro (text-to-video)Pro 품질 텍스트→동영상3-15s54/s (no audio) · 80/s (with audio)
pro (image-to-video)Pro 품질 이미지→동영상3-15s54/s (no audio) · 80/s (with audio)
std (text-to-video)표준 품질 텍스트→동영상3-15s40/s (no audio) · 60/s (with audio)
std (image-to-video)표준 품질 이미지→동영상3-15s40/s (no audio) · 60/s (with audio)

API 엔드포인트

새 동영상 생성 작업을 만듭니다. model 필드는 'happyhorse-1.0/video'여야 합니다.

요청 본문

본문 매개변수JSON
model:string

모델 이름, 'happyhorse-1.0/video'여야 합니다

prompt:optional string

생성할 동영상 설명 텍스트(최대 2500자). multi_shots가 true이면 필수 아님.

mode:optional string

품질 모드: 'pro' 또는 'std'(기본: std) Defaults to std.

duration:optional number

동영상 길이(초), 3~15, 기본 5 Defaults to 5.

aspect_ratio:optional string

출력 화면비(16:9, 9:16, 1:1) Defaults to 16:9.

image_urls:optional string[]

이미지→동영상용 이미지 URL 배열

sound:optional boolean

네이티브 오디오 생성 사용(기본: true) Defaults to true.

cfg_scale:optional number

프롬프트 준수 강도(0-1, 기본: 0.5). 높을수록 프롬프트에 더 충실합니다. Defaults to 0.5.

multi_shots:optional boolean

여러 프롬프트가 있는 멀티샷 모드 Defaults to false.

multi_prompt:optional array

멀티샷 모드용 'prompt, duration' 객체 배열

happyhorse_elements:optional array

요소 객체 배열. 프롬프트에는 해당 요소의 name 앞에 @를 붙여 참조(예: name이 element_dog이면 @element_dog). 각 요소: name, description, element_input_urls(2-4 이미지 URL). 작업당 최대 3개.

텍스트→동영상

json
{
  "model": "happyhorse-1.0/video",
  "prompt": "A majestic eagle soaring through clouds at sunset",
  "mode": "pro",
  "duration": 5,
  "aspect_ratio": "16:9",
  "sound": true
}

이미지→동영상

json
{
  "model": "happyhorse-1.0/video",
  "prompt": "The character slowly turns and smiles",
  "mode": "pro",
  "image_urls": ["https://example.com/my-image.jpg"],
  "duration": 5
}

멀티샷 동영상

json
{
  "model": "happyhorse-1.0/video",
  "mode": "pro",
  "multi_shots": true,
  "multi_prompt": [
    { "prompt": "A woman walks into a coffee shop", "duration": 3 },
    { "prompt": "She orders a latte and sits by the window", "duration": 4 },
    { "prompt": "She looks outside and smiles", "duration": 3 }
  ],
  "aspect_ratio": "16:9"
}

응답

Task created successfully

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n92abc123hh10",
    "status": "IN_PROGRESS"
  }
}

generate가 반환한 task_id로 동영상 생성 작업 상태를 확인합니다.

쿼리 매개변수

쿼리 매개변수
task_id:string

generate가 반환한 고유 작업 ID(n92 접두사)

요청 예시

bash
curl -X GET 'https://happyhorse.app/api/status?task_id=n92abc123hh10' \
  -H 'Authorization: Bearer YOUR_API_KEY'

팁: response 필드에 resultUrls 배열이 있습니다. 동영상 URL은 data.response.resultUrls[0]에서 가져옵니다.

javascript
// Extract video URL from response
const videoUrl = data.response.resultUrls[0];

응답

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n92abc123hh10",
    "status": "SUCCESS",
    "consumed_credits": 400,
    "created_at": "2026-04-08T10:30:00Z",
    "type": "text-to-video",
    "request": {
      "model": "happyhorse-1.0/video",
      "prompt": "A majestic eagle soaring through clouds at sunset",
      "mode": "pro",
      "duration": 5,
      "aspect_ratio": "16:9"
    },
    "response": {
      "resultUrls": [
        "https://cdn.example.com/videos/abc123.mp4"
      ]
    },
    "error_message": null
  }
}

API 플레이그라운드

브라우저에서 바로 API를 테스트하세요. YOUR_API_KEY를 실제 키로 바꾸세요.

API 플레이그라운드POST

오류 코드

HTTP 상태코드설명
400 잘못된 요청INVALID_PROMPT프롬프트가 잘못되었거나 비어 있습니다
400 잘못된 요청INVALID_DURATION지원 범위를 벗어난 길이(3~15초)
400 잘못된 요청INVALID_MODEL모델은 'happyhorse-1.0/video'여야 합니다
401 인증되지 않음INVALID_API_KEYAPI 키가 없거나 잘못되었습니다
402 결제 필요INSUFFICIENT_CREDITS이 작업에 크레딧이 부족합니다
429 요청 과다RATE_LIMITED요청이 너무 많습니다. 잠시 후 다시 시도하세요
500 내부 서버 오류INTERNAL_ERROR서버 오류입니다. 나중에 다시 시도하세요