지도 시간

EvoLink에서 HappyHorse API 사용하는 방법

Q: HappyHorse를 호출할 때 어떤 엔드포인트를 사용하나요?

POST /v1/videos/generations로 작업을 생성하고, GET /v1/tasks/{task_id}로 작업 상태와 결과를 조회합니다.

Q: 어떤 HappyHorse 모델명을 사용해야 하나요?

프롬프트 우선 테스트는 happyhorse-1.0-text-to-video부터 시작하세요. 워크플로에 이미지, 참조 이미지, 소스 비디오가 필요한 경우 happyhorse-1.0-image-to-video, happyhorse-1.0-reference-to-video, happyhorse-1.0-video-edit를 사용하세요.

EvoLink Team

Product Team

2026년 4월 27일

7분 소요

HappyHorse API 가이드: EvoLink를 통한 HappyHorse 1.0 호출

HappyHorse 1.0을 EvoLink의 통합 비디오 API로 바로 사용할 수 있습니다. **"HappyHorse API"**를 찾고 계시다면, 가장 빠른 방법은 HappyHorse API 페이지에서 모델 테스트, 현재 라우팅 요금 확인, 실시간 API 엔드포인트 점검을 하는 것입니다.

이 가이드는 개발자를 위한 통합 세부 사항을 다룹니다. 모델 페이지는 거래형 검색을 담당하고, 이 글은 연동 과정 전반을 설명합니다.

빠른 시작

POST /v1/videos/generations로 HappyHorse 비디오 작업을 생성합니다.
GET /v1/tasks/{task_id}로 비동기 결과를 폴링합니다.
현재 사용 가능한 라우트 변형: happyhorse-1.0-text-to-video, happyhorse-1.0-image-to-video, happyhorse-1.0-reference-to-video, happyhorse-1.0-video-edit.
EvoLink 라우팅 요금은 초당 과금 방식이며, 현재 720p 기준 12.15 credits/s, 1080p는 1.778x 배율 적용.
API 접근, 요금, Playground 테스트는 HappyHorse API 페이지에서 확인하세요.

HappyHorse API 모델명

워크플로	모델명	용도
텍스트 투 비디오	`happyhorse-1.0-text-to-video`	프롬프트 기반 비디오 생성
이미지 투 비디오	`happyhorse-1.0-image-to-video`	첫 프레임 이미지를 애니메이션화
참조 이미지 투 비디오	`happyhorse-1.0-reference-to-video`	1~9장의 참조 이미지 활용
비디오 편집	`happyhorse-1.0-video-edit`	텍스트 지시로 소스 비디오 편집

이 변형들은 동일한 EvoLink 패턴을 공유합니다: 비동기 생성 작업 제출, 작업 ID 수신, 완료 후 결과 가져오기.

기본 요청 패턴

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <EVOLINK_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.0-text-to-video",
    "prompt": "크롬 금속 질감의 말 조각상이 검은 유리 테이블 위에서 천천히 회전하고, 스튜디오 조명, 카메라가 천천히 줌인",
    "quality": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

응답으로 작업 ID가 반환되며, 해당 ID로 작업 엔드포인트를 폴링합니다:

curl --request GET \
  --url https://api.evolink.ai/v1/tasks/<TASK_ID> \
  --header 'Authorization: Bearer <EVOLINK_API_KEY>'

먼저 확인할 파라미터

파라미터	일반적인 값	설명
`model`	`happyhorse-1.0-text-to-video`	워크플로에 맞는 HappyHorse 변형 선택
`prompt`	텍스트 프롬프트	프롬프트 기반 생성 및 편집 시 필수
`quality`	`720p`, `1080p`	1080p는 더 높은 배율 적용
`duration`	`3-15`초	생성 변형에 적용, 비디오 편집에는 해당 없음
`aspect_ratio`	`16:9`, `9:16`, `1:1`, `4:3`, `3:4`	텍스트 투 비디오 및 참조 이미지 투 비디오에서 비율 선택 가능
`image_urls`	이미지 1장 또는 참조 이미지 1~9장	이미지 투 비디오/참조 이미지 워크플로 필수
`video_urls`	소스 비디오 URL	비디오 편집 필수

HappyHorse 변형별 사용 시점

텍스트 투 비디오로 HappyHorse 품질을 처음 테스트하세요. happyhorse api, happyhorse 텍스트 투 비디오 관련 검색에 가장 적합합니다.

이미지 투 비디오는 첫 프레임 구성이 중요할 때 사용하세요. 제품 비주얼, 캐릭터 일관성, 디자인 중심의 크리에이티브 테스트에 적합합니다.

참조 이미지 투 비디오는 여러 참조 이미지가 있고 프롬프트에서 이를 캐릭터나 오브젝트로 참조하고 싶을 때 사용하세요.

비디오 편집은 이미 소스 비디오가 있고 지시문으로 수정하고 싶을 때 사용하세요. 비디오 편집 과금은 단순한 출력 길이 추정이 아닌 총 재생 시간 규칙을 따릅니다.

요금 범위

이 가이드에서 다루는 것은 EvoLink 라우팅 요금이며, 공식 벤더 가격이 아닙니다.

현재 HappyHorse 요금 구조:

화질	요금 기준
720p	`12.15 credits/s`
1080p	720p 요율의 `1.778x`

비디오 편집은 특수 시간 규칙 적용: 입력 비디오 길이 + 출력 비디오 길이 기반 과금이며, 소스 비디오 길이에 과금 상한이 있습니다. 실제 사용 전 HappyHorse API 페이지에서 실시간 요금표를 확인하세요.

SEO 콘텐츠 클러스터에서 이 페이지의 위치

검색 쿼리	최적 랜딩 페이지
`happyhorse api`	HappyHorse API 페이지
`happyhorse api 사용법`	이 가이드
`happyhorse 가격`	HappyHorse 요금 가이드
`happyhorse vs seedance`	HappyHorse vs Seedance
`happyhorse 오픈소스`	HappyHorse 출시 관찰

HappyHorse API 페이지 열기

자주 묻는 질문

HappyHorse API를 지금 사용할 수 있나요?

네. HappyHorse 1.0은 현재 EvoLink의 통합 비디오 API를 통해 사용 가능합니다.

HappyHorse를 호출할 때 어떤 엔드포인트를 사용하나요?

POST /v1/videos/generations로 작업을 생성하고, GET /v1/tasks/{task_id}로 작업 상태와 결과를 조회합니다.

어떤 HappyHorse 모델명을 사용해야 하나요?

프롬프트 우선 테스트는 happyhorse-1.0-text-to-video부터 시작하세요. 워크플로에 이미지, 참조 이미지, 소스 비디오가 필요한 경우 happyhorse-1.0-image-to-video, happyhorse-1.0-reference-to-video, happyhorse-1.0-video-edit를 사용하세요.