개요
**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를 선택해야 하는 이유
모든 기능을 위한 하나의 키
직접 접속, VPN 불필요
api.apiyi.com에 직접 연결할 수 있으며, 국내 데이터센터와 가정용 브로드밴드에서 이용 가능합니다.실패 시 과금 없음
failed 상태에 진입한 작업(접근할 수 없는 미디어 URL, 민감한 prompt 등)은 과금되지 않으므로, 안심하고 다시 시도하실 수 있습니다.DashScope 프로토콜 패스스루
model 이름만 바꾸면 HappyHorse를 호출할 수 있습니다.핵심 기능
4-in-1 비동기 엔드포인트
POST /wan/api/v1/...video-synthesis를 공유합니다; 제출 후에는 task_id를 반환하며, 그다음 폴링하여 다운로드합니다.고충실도 피사체 보존
최대 9개의 참조 이미지
happyhorse-1.1-r2v는 공식적으로 최대 9개의 reference_image 항목을 지원하여, 다중 참조 시나리오에서 피사체 일관성을 더 높입니다.다양한 해상도와 지속 시간
prompt_extend 스마트 재작성입니다.지원 모델
⚠️ 엔드포인트 선택 (가장 중요)
APIYI는 두 경로를 동시에 마운트하며, DashScope 패스스루 엔드포인트만 모든 HappyHorse 기능에 대해 완전히 사용할 수 있습니다:비동기 호출 흐름
전체 흐름은 비동기 방식이며, 세 단계로 진행됩니다: 작업 생성 → 상태 폴링 → 동영상 다운로드.작업 생성
POST /wan/api/v1/services/aigc/video-generation/video-synthesis, 요청 헤더 X-DashScope-Async: enable와 함께 사용합니다. 즉시 task_id을 반환합니다.상태 폴링
GET /v1/tasks/{task_id}(Authorization와 함께), 5~10초마다(3초 미만으로는 하지 않음) 조회하며, status이 completed가 될 때까지 반복합니다.동영상 다운로드
result_url에서 mp4를 직접 GET하며, Authorization 헤더는 사용하지 않습니다(서명된 OSS 직접 링크이므로 Auth를 포함하면 403이 발생합니다).작업 상태 참고
전체 Python 클라이언트
주요 매개변수 설명
제출할 때 본문은 DashScope 중첩 구조를 사용합니다:{ model, input: { prompt, media[] }, parameters: {...} }.
media[] 유형
parameters 필드
HappyHorse와 Wan 중 선택하는 방법
HappyHorse와 Wan은 모두 동일한 엔드포인트와 스키마를 공유하는 Alibaba 동영상 모델입니다(model 이름만 바꾸면 서로 대체 가능하지만), 강조하는 점은 서로 다릅니다:
모범 사례
먼저 720P / 5초로 반복합니다
prompt_extend를 항상 활성화합니다
prompt_extend: true는 짧은 prompt의 품질을 눈에 띄게 향상합니다.5-10초마다 폴링합니다
안전장치로 20분의 클라이언트 타임아웃을 설정합니다
result_url을 받으면 즉시 다운로드합니다
result_url 기본적으로 24시간 후 만료되며, 서명된 OSS 직접 링크이므로 다운로드할 때 Authorization 헤더를 포함하지 마십시오.오류 코드와 재시도
failed task with [InvalidImageUrl] is retryable, while [InvalidParameter] / 민감어 실패는 재시도할 수 없습니다.자주 묻는 질문
HappyHorse와 Wan은 통합 방식에 차이가 있습니까?
HappyHorse와 Wan은 통합 방식에 차이가 있습니까?
model 필드만 변경됩니다 (예: wan2.7-t2v → happyhorse-1.1-t2v); 본문 나머지는 동일하게 유지됩니다.HappyHorse의 i2v는 왜 립싱크를 할 수 없습니까?
HappyHorse의 i2v는 왜 립싱크를 할 수 없습니까?
happyhorse-1.1-i2v는 driving_audio(오디오 기반) 필드를 지원하지 않으며, i2v는 first_frame만 허용합니다. 립싱크 / 랩 / 디지털 휴먼 보이스오버에는 Wan2.7-i2v를 사용하십시오.happyhorse-1.1-r2v는 정말 기준 이미지를 9장까지 받을 수 있습니까?
happyhorse-1.1-r2v는 정말 기준 이미지를 9장까지 받을 수 있습니까?
reference_image 항목을 지원하며, media 배열에 넣으면 됩니다. 참조 이미지가 많을수록 대상 / 의상 / 장면의 일관성이 더 강해집니다./v1/videos를 통해 제출할 수 없는 이유는 무엇입니까?
/v1/videos를 통해 제출할 수 없는 이유는 무엇입니까?
/v1/videos는 i2v / r2v의 media 필드를 완전히 지원하지 않아 업스트림에서 [InvalidParameter] Field required: input.media를 반환하게 됩니다. 모든 생성 요청은 /wan/api/v1/services/aigc/video-generation/video-synthesis를 통해 처리되며, 조회는 /v1/tasks/{task_id}를 통해 처리됩니다.result_url을 다운로드할 때 403이 반환되면 어떻게 합니까?
result_url을 다운로드할 때 403이 반환되면 어떻게 합니까?
Authorization 헤더를 제거하십시오. result_url는 이미 서명된 OSS 직접 링크이므로, 여기에 APIYI Key를 추가하면 OSS에서 거부합니다. result_url는 기본적으로 24시간 후 만료되므로 즉시 다운로드하십시오.실패한 작업도 과금됩니까?
실패한 작업도 과금됩니까?
status=failed는 과금되지 않습니다. 하지만 같은 작업을 다시 제출하면 다시 과금되므로 멱등성을 처리하십시오.그룹 설정
HappyHorse와 Wan 시리즈는 하나의Wan&HappyHorse 그룹을 공유합니다 — 하나의 Token으로 두 시리즈를 모두 호출할 수 있습니다. 동영상 모델은 초당 과금되므로, Token이 성공적으로 라우팅되려면 두 가지 조건을 충족해야 합니다:
- 과금 모델: Pay-as-you-go Priority 또는 Pay-as-you-go를 선택합니다 — 동영상은 초당 과금되므로 Pay-per-request Tokens는 라우팅할 수 없습니다
- 그룹:
Wan&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 환율로 과금하므로, 실효 환산은:
환산: 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배까지 늘릴 수 있어 실효 가격을 더 낮출 수 있습니다:관련 문서
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 의상 교체 / 배경 교체