HappyHorse 1.1 API
HappyHorse 1.1은 OmniaKey에서 제공하는 Alibaba의 최신 HappyHorse 동영상 제품군입니다. 하나의 카드가 세 가지 사용법을 다루며 각각 전용 모델 ID를 가집니다. happyhorse-1.1-t2v(텍스트에서), happyhorse-1.1-i2v(첫 프레임에서), happyhorse-1.1-r2v(최대 9장의 참조 이미지에서)입니다.
- 호출 가능한 모델 ID
- happyhorse-1.1-t2vhappyhorse-1.1-i2vhappyhorse-1.1-r2v
- 공급자
- Alibaba
- 유형
- AI 영상
- 출력 1초당
- $0.07–$0.18
- 마지막 확인
- 2026-09-14
01
어울리는 용도
제품군에서 가장 매끄러운 움직임과 조명, 피사체 일관성을 원하면 HappyHorse 1.1을 선택하세요. 해상도에 따라 초당 $0.07~$0.18입니다. 프롬프트를 1.0 화풍에 맞춰 둔 경우에만 HappyHorse 1.0으로 내려가세요.
02
할 수 있는 일
텍스트를 비디오로
happyhorse-1.1-t2v
텍스트 프롬프트로 짧은 영상 클립을 생성합니다.
이미지를 비디오로
happyhorse-1.1-i2v
정지 이미지를 짧은 영상 클립으로 움직입니다.
참고영상
happyhorse-1.1-r2v
참조 영상으로 생성 클립을 유도합니다.
03
호출 방법
미디어 모델은 비동기로 동작합니다. 작업을 만들고 완료될 때까지 폴링한 뒤 서명된 에셋 URL을 내려받으세요.
# 1. Create the job. 202 Accepted; the body carries the task id,
# the pre-charged price, and a poll_url. Reuse one Idempotency-Key
# across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
-H "Authorization: Bearer $OMNIAKEY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: happyhorse-1.1-001" \
-d '{
"model": "happyhorse-1.1-t2v",
"type": "video",
"operation": "text_to_video",
"input": {"prompt": "a paper boat on a quiet lake at sunset"},
"parameters": {"duration": 6, "resolution": "720p"}
}'
# 2. The operation picks the model id on this route:
# happyhorse-1.1-t2v prompt only
# happyhorse-1.1-i2v media[] type "first_frame"
# happyhorse-1.1-r2v media[] type "reference_image"
# 3. Poll GET /v1/media/tasks/{id} until status is
# succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
-H "Authorization: Bearer $OMNIAKEY_API_KEY"
# 4. Download assets[0].url before expires_at, or poll again for a
# fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.mp4 "$(jq -r '.assets[0].url' result.json)"04
가격
비디오 작업은 토큰이 아니라 생성된 출력 초당 과금됩니다. 실패하거나 취소된 작업은 자동으로 환불됩니다.
$0.07–$0.18초당
- 480P
- $0.07초당
- 720P
- $0.14초당
- 1080P
- $0.18초당
Alibaba의 다른 모델
자주 묻는 질문
OmniaKey에서 HappyHorse 1.1을(를) 어떻게 호출하나요?
모델 id, type "video", operation "text_to_video"와 함께 /v1/media/tasks로 POST하세요. 첫 프레임에서 만들 때는 operation을 "image_to_video"로 바꾸고 input.media[](type은 "first_frame")에 넣습니다. 재시도 시 같은 Idempotency-Key를 쓰면 타임아웃으로 두 번째 유료 작업이 생기지 않습니다.
HappyHorse 1.1 비용은 얼마인가요?
HappyHorse 1.1의 요금은 $0.07–$0.18 초당이며, 생성된 비디오 길이에 따라 과금됩니다. 생성 시 요청한 길이만큼 선불 잔액에서 미리 차감되며, 실패하거나 취소된 작업은 자동으로 환불됩니다.
왜 API가 비디오 대신 작업 id를 반환하나요?
비디오 렌더링은 1분에서 몇 분까지 걸리므로 OmniaKey는 모든 비디오 경로를 하나의 비동기 흐름으로 처리합니다. 상태가 succeeded가 될 때까지 GET /v1/media/tasks/{id}를 폴링한 뒤 서명된 에셋 URL을 읽으세요.
