PopNow APIpopnow.ai
API 키 받기

HappyHorse 1.1 API

Alibaba

9가지 화면비의 사운드 포함 1080p 클립

alibaba/happyhorse-1.1/text-to-video105크레딧부터/ 5초 영상 · US$1.05
Playground에서 써 보기API 키 받기
  • 최대 1080p
  • 3–15초
  • 참조 이미지 최대 9장
  • 화면비 9종
  • 동영상 만들기
  • 이미지로 영상 만들기
  • 레퍼런스로 영상 만들기
예시 보기

HappyHorse 1.1 소개

HappyHorse 1.1은 Alibaba의 동영상 패밀리이고 엔드포인트가 셋입니다. text-to-video, image-to-video, 그리고 레퍼런스 이미지를 최대 아홉 장까지 받는 reference-to-video입니다. 클립은 720p와 1080p에서 3초부터 15초까지 나오고, 4:5와 5:4, 21:9, 9:21을 포함한 아홉 가지 화면비를 지원합니다.

POST /jobs/createTask에서 모델 이름을 alibaba/happyhorse-1.1/text-to-video(으)로 지정하면 호출할 수 있습니다. 105크레딧/ 5초 영상부터(US$1.05). 새 계정에는 30크레딧이 지급되니 Playground에서 먼저 무료로 써 보세요.

이 가이드는 당분간 영어로만 제공됩니다. →

요청 파라미터

파라미터필수설명
prompt예Describe the scene, action, camera movement, and timing.
resolution아니요출력 크기. 클수록 선명하고 가격도 올라갑니다. 720p · 1080p · 기본값: 720p
aspect_ratio아니요화면 모양: 가로, 정사각형, 세로. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 4:5 · 5:4 · 9:21 · 21:9 · 기본값: 16:9
duration_seconds아니요클립 길이. 초 단위로 요금이 붙습니다. ≥ 3 · ≤ 15 · 기본값: 5

가격

가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.

옵션크레딧 /초≈ USD
resolution 720p21US$0.21
resolution 1080p27US$0.27

실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.

API 빠른 시작

HappyHorse 1.1 API를 3단계로 호출하기

  1. API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
  2. 요청 보내기. POST /jobs/createTask에 model은 alibaba/happyhorse-1.1/text-to-video, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
  3. 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/happyhorse-1.1/text-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.

HappyHorse 1.1 API 질문

HappyHorse 1.1 API 요금은 얼마인가요?

HappyHorse 1.1 가격은 가장 저렴한 동영상 만들기 기준 105크레딧(US$1.05) / 5초 영상부터입니다. 옵션별 가격: 720p 21크레딧/초, 1080p 27크레딧/초. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.

API에서 HappyHorse 1.1의 모델 이름은 무엇인가요?

POST /jobs/createTask의 model 필드에 동영상 만들기: alibaba/happyhorse-1.1/text-to-video; 이미지로 영상 만들기: alibaba/happyhorse-1.1/image-to-video; 레퍼런스로 영상 만들기: alibaba/happyhorse-1.1/reference-to-video을(를) 넣으세요.

HappyHorse 1.1은 레퍼런스 이미지를 몇 장까지 받나요?

reference-to-video에서 한 장에서 아홉 장까지이고, 거기서는 필수 필드입니다. 프롬프트가 부르는 순서대로 보내고, 이미지마다 역할을 하나씩만 주세요. 같은 피사체를 겹치게 아홉 장 넣으면 조율되는 게 아니라 평균이 나옵니다.

어떤 화면비를 쓸 수 있나요?

아홉 가지입니다. 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9이고 기본값은 16:9입니다. text-to-video와 reference-to-video에 노출되고, image-to-video는 첫 프레임에서 형태를 가져옵니다.

HappyHorse 1.1이 오디오를 만들어 주나요?

네. 세 엔드포인트 모두 오디오 필드는 없지만 클립에는 생성된 오디오 트랙이 붙어 돌아오므로 끌 방법이 없습니다. 원하는 소리는 프롬프트에서 묘사하고, 직접 만든 믹스 밑에 깔 때는 편집에서 트랙을 음소거하거나 바꾸세요.

클립의 마지막 프레임을 고정할 수 있나요?

아니요. image-to-video에는 마지막 프레임 필드가 없고 image_url뿐입니다. 컷이 특정 구도에 도착해야 한다면 그 구도를 뒤집은 동작의 첫 프레임으로 쓰거나, 편집에서 그리로 컷을 넘기세요.

어떤 해상도를 지원하나요?

720p와 1080p이고 모든 엔드포인트에서 기본값은 720p입니다. 720p로 초안을 잡고 원하는 컷을 1080p에서 다시 돌리세요. 돌릴 때마다 다른 컷이 나오니 같은 그림을 기대하기보다 문장을 고정해 두는 편이 낫습니다.

HappyHorse 1.1 API의 제한은 무엇인가요?

영상 길이: 3–15 s; 해상도: 720p · 1080p; 화면 비율: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 4:5 +3; 프롬프트 길이(글자): 2,500. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.

코드 없이 HappyHorse 1.1을(를) 써 볼 수 있나요?

네. Playground에서는 API 키 없이 PopNow 크레딧으로 HappyHorse 1.1을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.

HappyHorse 1.1 더 알아보기