Skip to main content

개요

**HappyHorse (快马)**는 Alibaba의 동영상 생성 모델 시리즈로, 고충실도 동적 동영상 생성에 중점을 둡니다. 텍스트 의미를 정밀하게 이해하고, 피사체를 안정적으로 유지하면서 부드럽고 자연스럽고 디테일이 풍부하며 고품질인 동영상을 출력합니다. APIYI는 DashScope 통과 채널을 통해 직접 연결되므로, 하나의 APIYI Key로 모든 HappyHorse 기능을 호출할 수 있습니다. 현재 플래그십 버전인 HappyHorse-1.1(Video Edit는 1.0입니다)은 네 가지 핵심 사용 사례를 포괄합니다:
🐎 핵심 포인트: 네 가지 기능은 모두 동일한 비동기 엔드포인트와 동일한 요청 구조를 공유합니다. 즉, 사용 사례를 전환해도 model 필드만 변경하면 됩니다. HappyHorse는 “고충실도 동적 동영상”에 더 가깝고, Reference-to-Video는 최대 9개의 참조 이미지를 지원하며 Video Edit는 최대 5개의 참조 이미지를 지원해 피사체 일관성이 뛰어납니다. Wan 시리즈와 동일한 엔드포인트를 사용하므로 직접 호환됩니다.

Text-to-Video API

happyhorse-1.1-t2v, 순수 텍스트 prompt에서 동영상을 생성합니다.

Image-to-Video API

happyhorse-1.1-i2v, 첫 프레임 이미지에서 동영상을 생성합니다(오디오 기반 아님).

Reference-to-Video API

happyhorse-1.1-r2v, 피사체를 보존하기 위해 최대 9개의 참조 이미지를 사용합니다.

Video Edit API

happyhorse-1.0-video-edit, 최대 5개의 참조 이미지를 사용해 동영상을 편집합니다.

HappyHorse에 APIYI를 선택해야 하는 이유

모든 기능을 위한 하나의 키

Alibaba Cloud 가입도, 리전 설정도 필요하지 않습니다. 하나의 APIYI 키로 HappyHorse의 네 가지 기능과 Wan 시리즈를 모두 호출할 수 있습니다.

직접 접속, VPN 불필요

api.apiyi.com에 직접 연결할 수 있으며, 국내 데이터센터와 가정용 브로드밴드에서 이용 가능합니다.

실패 시 과금 없음

failed 상태에 진입한 작업(접근할 수 없는 미디어 URL, 민감한 prompt 등)은 과금되지 않으므로, 안심하고 다시 시도하실 수 있습니다.

DashScope 프로토콜 패스스루

Wan 시리즈와 동일한 엔드포인트와 스키마를 사용합니다. 기존 Wan 코드는 model 이름만 바꾸면 HappyHorse를 호출할 수 있습니다.

핵심 기능

4-in-1 비동기 엔드포인트

t2v / i2v / r2v / video-edit가 POST /wan/api/v1/...video-synthesis를 공유합니다; 제출 후에는 task_id를 반환하며, 그다음 폴링하여 다운로드합니다.

고충실도 피사체 보존

모델은 “고충실도 동적 비디오” 스타일에 더 가깝게 작동하여, 움직임 전반에서 사람과 객체를 더 안정적으로 유지합니다.

최대 9개의 참조 이미지

happyhorse-1.1-r2v는 공식적으로 최대 9개의 reference_image 항목을 지원하여, 다중 참조 시나리오에서 피사체 일관성을 더 높입니다.

다양한 해상도와 지속 시간

720P / 1080P 해상도, 2–15초의 정수 지속 시간, 그리고 짧은 prompt의 품질을 높이는 prompt_extend 스마트 재작성입니다.

지원 모델

⚠️ 엔드포인트 선택 (가장 중요)

APIYI는 두 경로를 동시에 마운트하며, DashScope 패스스루 엔드포인트만 모든 HappyHorse 기능에 대해 완전히 사용할 수 있습니다:
HappyHorse와 Wan은 동일한 패스스루 엔드포인트를 공유합니다. /v1/videos를 통해 동영상 작업을 제출하는 문서/예시가 보이면, 무시하십시오. 모든 생성 요청은 /wan/api/v1/...video-synthesis를 통해 이루어지고, 모든 조회는 /v1/tasks/{task_id}를 통해 이루어집니다.

비동기 호출 흐름

전체 흐름은 비동기 방식이며, 세 단계로 진행됩니다: 작업 생성 → 상태 폴링 → 동영상 다운로드.
1

작업 생성

POST /wan/api/v1/services/aigc/video-generation/video-synthesis, 요청 헤더 X-DashScope-Async: enable와 함께 사용합니다. 즉시 task_id을 반환합니다.
2

상태 폴링

GET /v1/tasks/{task_id}(Authorization와 함께), 5~10초마다(3초 미만으로는 하지 않음) 조회하며, statuscompleted가 될 때까지 반복합니다.
3

동영상 다운로드

응답의 result_url에서 mp4를 직접 GET하며, Authorization 헤더는 사용하지 않습니다(서명된 OSS 직접 링크이므로 Auth를 포함하면 403이 발생합니다).

작업 상태 참고

전체 Python 클라이언트

주요 매개변수 설명

제출할 때 본문은 DashScope 중첩 구조를 사용합니다: { model, input: { prompt, media[] }, parameters: {...} }.

media[] 유형

HappyHorse의 i2v는 driving_audio을 지원하지 않습니다(audio-driven은 Wan2.7-i2v에만 있는 기능입니다). 립싱크 / 랩에는 Wan2.7을 사용하십시오.

parameters 필드

duration는 문자열 5이 아니라 정수 "5"여야 합니다. 대문자resolution를 쓰는 720P이 더 안정적입니다.

HappyHorse와 Wan 중 선택하는 방법

HappyHorse와 Wan은 모두 동일한 엔드포인트와 스키마를 공유하는 Alibaba 동영상 모델입니다(model 이름만 바꾸면 서로 대체 가능하지만), 강조하는 점은 서로 다릅니다:
피사체 일관성을 유지하기 위해 여러 참조 이미지가 필요합니다happyhorse-1.1-r2v를 선택하십시오(최대 9장). 립싱크 / 랩 / 디지털 휴먼 보이스오버가 필요합니다Wan2.7-i2v를 선택하십시오(오디오 기반을 지원하는 유일한 모델입니다).

모범 사례

1

먼저 720P / 5초로 반복합니다

개발 단계에서는 저해상도의 짧은 동영상을 사용해 prompt와 참조 이미지를 빠르게 검증한 다음, 최종 확정 후 해상도와 길이를 높입니다.
2

prompt_extend를 항상 활성화합니다

prompt_extend: true는 짧은 prompt의 품질을 눈에 띄게 향상합니다.
3

5-10초마다 폴링합니다

3초 미만으로 줄이지 마십시오(요청 제한이 걸립니다). 각 HappyHorse 기능은 720P / 5초 기준으로 일반적으로 105–115초가 걸립니다.
4

안전장치로 20분의 클라이언트 타임아웃을 설정합니다

1080P 또는 긴 동영상은 훨씬 느립니다; 폴링 루프에 20분의 대체 타임아웃을 설정합니다.
5

result_url을 받으면 즉시 다운로드합니다

result_url 기본적으로 24시간 후 만료되며, 서명된 OSS 직접 링크이므로 다운로드할 때 Authorization 헤더를 포함하지 마십시오.

오류 코드와 재시도

권장 클라이언트 동작: HTTP 5xx / 네트워크 오류에는 지수 백오프 재시도를 사용합니다. HTTP 4xx는 재시도하지 말고 즉시 표출합니다. failed task with [InvalidImageUrl] is retryable, while [InvalidParameter] / 민감어 실패는 재시도할 수 없습니다.

자주 묻는 질문

아니요. 둘은 동일한 DashScope passthrough 엔드포인트, 동일한 요청 구조, 동일한 미디어 유형 이름 집합, 동일한 query 엔드포인트를 사용합니다. 전환하면 model 필드만 변경됩니다 (예: wan2.7-t2vhappyhorse-1.1-t2v); 본문 나머지는 동일하게 유지됩니다.
happyhorse-1.1-i2vdriving_audio(오디오 기반) 필드를 지원하지 않으며, i2v는 first_frame만 허용합니다. 립싱크 / 랩 / 디지털 휴먼 보이스오버에는 Wan2.7-i2v를 사용하십시오.
예. 공식적으로 최대 9개의 reference_image 항목을 지원하며, media 배열에 넣으면 됩니다. 참조 이미지가 많을수록 대상 / 의상 / 장면의 일관성이 더 강해집니다.
/v1/videos는 i2v / r2v의 media 필드를 완전히 지원하지 않아 업스트림에서 [InvalidParameter] Field required: input.media를 반환하게 됩니다. 모든 생성 요청은 /wan/api/v1/services/aigc/video-generation/video-synthesis를 통해 처리되며, 조회는 /v1/tasks/{task_id}를 통해 처리됩니다.
Authorization 헤더를 제거하십시오. result_url는 이미 서명된 OSS 직접 링크이므로, 여기에 APIYI Key를 추가하면 OSS에서 거부합니다. result_url는 기본적으로 24시간 후 만료되므로 즉시 다운로드하십시오.
status=failed는 과금되지 않습니다. 하지만 같은 작업을 다시 제출하면 다시 과금되므로 멱등성을 처리하십시오.

그룹 설정

HappyHorse와 Wan 시리즈는 하나의 Wan&HappyHorse 그룹을 공유합니다 — 하나의 Token으로 두 시리즈를 모두 호출할 수 있습니다. 동영상 모델은 초당 과금되므로, Token이 성공적으로 라우팅되려면 두 가지 조건을 충족해야 합니다:
  1. 과금 모델: Pay-as-you-go Priority 또는 Pay-as-you-go를 선택합니다 — 동영상은 초당 과금되므로 Pay-per-request Tokens는 라우팅할 수 없습니다
  2. 그룹: Wan&HappyHorse를 포함하는 그룹을 선택합니다
Token 생성 대화상자: 과금 모델이 Pay-as-you-go Priority로 설정되어 있고, 그룹 드롭다운에 Wan&HappyHorse(요율 배수 0.14x)가 표시되며, 하나의 Token으로 Wan2.7과 HappyHorse를 모두 사용할 수 있습니다

Create Token: set billing model to Pay-as-you-go Priority and group to Wan&HappyHorse (0.14x) to call every Wan2.7 and HappyHorse video model (the screenshot shows the group's former name Wan, since renamed to Wan&HappyHorse)

가격

기본 가격 = Alibaba 공식 가격의 98%입니다(이해하기 쉽습니다)

HappyHorse 모델 가격은 APIYI 시스템에 내장되어 있습니다 — 수동 설정이 필요 없으며, 그룹 할인은 자동으로 적용됩니다. 콘솔에서 Wan&HappyHorse 그룹은 0.14x 요율을 표시하며, 이는 내장된 RMB 가격 단위로 표시됩니다. APIYI는 USD를 고정 1:7 환율로 과금하므로, 실효 환산은:
즉, **기본 가격 = Alibaba 공식 가격의 98%**입니다 — Alibaba에서 직접 구매하는 것보다 저렴하며, 별도의 해외 연동을 직접 구축할 필요가 없습니다.
환산: USD 초당 가격 = 공식 RMB 가격 × 0.14 (즉, × 0.98 ÷ 7).

가격 세부사항(기본 가격, 초당 과금)

HappyHorse-1.1 text-to-video / image-to-video / reference-to-video는 동일한 가격이며, 두 단계인 720P / 1080P입니다(480P는 지원되지 않습니다):
  • happyhorse-1.0-video-edit 출력 길이는 원본 동영상을 따르며, duration이 아니라 실제 출력 초 단위로 과금됩니다.
  • 표시된 가격은 **기본(공식의 98%)**이며, 최대 충전 보너스를 적용하면 실효 가격은 대략 표 값 ÷ 1.2입니다(예: 1080P 5초 $1.12 → 약 $0.93).

더 낮은 실효 가격을 위한 충전 보너스 누적

top-up bonus program에 가입하면 적립된 잔액을 최대 약 1.2배까지 늘릴 수 있어 실효 가격을 더 낮출 수 있습니다:
따라서 대량 고객은 **공식 가격의 약 81%**까지 낮출 수 있습니다(0.98 ÷ 1.2 ≈ 0.816).
  • 과금 기준 = **해상도 등급 × 지속 시간(초)**이며, 실패한 작업은 과금되지 않습니다.
  • 1:7은 고정 정산 환율입니다(우대 환율이 아닙니다); 모든 USD 충전에 동일하게 적용됩니다.
  • 최고 보너스 등급과 적용 가능한 채널은 충전 보너스를 참고하십시오. 최신 요율은 콘솔이 기준입니다.

관련 문서

Text-to-Video 플레이그라운드

happyhorse-1.1-t2v 온라인 디버깅

Image-to-Video 플레이그라운드

happyhorse-1.1-i2v 첫 프레임 생성

Reference-to-Video 플레이그라운드

happyhorse-1.1-r2v 참조 이미지 최대 9장

Video Edit 플레이그라운드

happyhorse-1.0-video-edit 의상 교체 / 배경 교체

Wan 시리즈

또한 Alibaba의 모델 선택 비교도 포함됩니다.
HappyHorse 시리즈는 APIYI DashScope 패스스루 채널을 통해 제공됩니다. 질문이나 제안이 있으시면 APIYI 콘솔에 티켓을 제출해 주십시오.