소개
HappyHorse 1.1 텍스트→영상은 Alibaba HappyHorse 1.1 계열에서 프롬프트만 입력으로 받는 엔드포인트입니다. 최대 2,500자 프롬프트로 720p 또는 1080p, 3~15초 정수 길이의 클립을 생성된 사운드트랙과 함께 돌려줍니다. 화면비는 21:9부터 9:21까지 9가지이며, 피드와 인쇄용 크롭인 4:5와 5:4도 포함됩니다. 이 엔드포인트는 프롬프트를 심사하며, 허용 범위를 넘는 브리프는 순화되지 않고 그대로 거부됩니다.
시작 자료에 따라 모드 선택하기
| 시작 자료 | 모드 |
|---|---|
| 작성한 장면이나 스크립트 | HappyHorse 1.1 텍스트→영상 |
| 승인된 시작 이미지 | HappyHorse 1.1 이미지→영상 |
| 참조 이미지 1~9장 | HappyHorse 1.1 참조→영상 |
핵심 기능 및 하이라이트
항목 하나로 고르는 9가지 화면비
aspect_ratio는 16:9(기본값), 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9를 받습니다. 여러 모양의 납품물을 만드는 일이 후반 작업에서 다시 자르는 대신 파라미터 하나를 바꿔 돌리는 일이 됩니다. rain-hood-convenience 예시는 이 목록의 세로 끝인 9:16, 1080p에 맞춰 썼고, 카메라에서 멀어지는 하나의 연속 동작에 단어를 씁니다.
끌 수 없는 사운드트랙
모든 클립은 생성된 오디오와 함께 돌아오며, 이를 끄는 항목은 없습니다. 원하는 소리를 프롬프트에 적으십시오. desert-tailgate 브리프는 매미 소리와 먼 고속도로 소리를 요청하고, rain-hood-convenience에서는 차양을 두드리는 빗소리가 영상과 같은 과정에서 함께 옵니다. 직접 만든 믹스 아래에 깔 때는 편집에서 트랙을 음소거하거나 교체하십시오.
720p로 초안, 1080p로 납품
길이는 3~15초의 정수이고 기본값은 5초이며, 해상도 기본값은 720p입니다. 둘 다 가격에 반영됩니다. 720p로 초안을 만들고 채택할 테이크를 1080p로 다시 실행하십시오. 실행마다 새 테이크가 나오므로, 더 높은 해상도에서 같은 프레임이 돌아오리라 기대하지 말고 문구를 고정해 비교하십시오.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 한 컷처럼 쓰세요. 피사체, 동작, 카메라, 빛, 호흡 순서로 적으면 됩니다. 1자 이상 · 2500자 이하 |
aspect_ratio | 아니요 | 아홉 가지 값이고 기본은 16:9입니다. 4:5와 5:4가 피드와 인쇄용 크롭입니다. |
resolution | 아니요 | 720p와 1080p 중에서 고릅니다. 초안은 720p, 납품은 1080p를 권장합니다. |
duration_seconds | 아니요 | 정수 초로 3에서 15까지입니다. 가격을 좌우합니다. |
요금
| 사양 | 요금 |
|---|---|
| $0.14 / 초 |
| $0.18 / 초 |
활용 사례
휴대폰 카메라 느낌의 세로 클립
karaoke-room 예시는 롤링 셔터, 휴대폰 카메라 노이즈, 약한 흔들림, 뒤섞인 네온 조명 같은 기기 룩을 이름으로 요청하며 9:16, 720p로 만들어졌습니다. 세로 화면에 두 사람이 나란히 앉아 마이크 하나로 후렴을 부르다 웃으며 서로에게 쓰러지고, 방 안의 소리도 영상과 함께 돌아옵니다.
빛으로 끌고 가는 무드 작품
움직이는 빛만으로 클립 전체를 붙잡을 수 있습니다. motel-blinds-boots에서는 베네치안 블라인드 사이로 들어온 호박색 가로등 빛이 피사체 위를 기어가는 동안, 그녀가 부츠 두 짝을 벗고 퀼트 위로 뒤로 쓰러집니다. 연속 동작이 기본값인 5초, 720p 안에 담깁니다. 방을 밝히는 것은 프롬프트가 묘사한 빛뿐입니다.
프레임을 만들기 전에 구도와 템포 정하기
피사체를 정확히 뽑아야 하거나 브리프가 이 엔드포인트의 허용 범위를 넘는다면, image-to-video의 시작 프레임이나 reference-to-video의 참조 세트를 거쳐야 합니다. text-to-video는 그런 입력을 준비하기 전에 몇 번의 짧은 초안으로 구도, 빛, 템포를 정하는 곳입니다.
프롬프트 가이드 및 실전 팁
샷으로 쓰기
피사체, 동작, 카메라, 빛, 템포를 보는 사람이 보게 되는 순서로 적습니다. desert-tailgate 프롬프트는 이를 한 문단에 해냅니다. 트럭 짐칸에 누가 앉아 무엇을 입었는지, 무엇을 하는지(부츠를 흔들고, 병을 기울이고, 낮은 해를 향해 눈을 가늘게 뜸), 이어서 ‘warm orange backlight, lens flare, handheld 35mm’, 마지막으로 소리입니다.
이 엔드포인트가 받는 범위 안에서 브리프 쓰기
프롬프트는 생성 전에 심사되며, 허용 범위를 넘는 묘사는 순한 클립이 아니라 거부로 돌아옵니다. 공개 예시는 모든 것을 말로 풀어 쓰는 대신 의상, 빛, 몸짓으로 표현합니다. 그 범위를 넘는 작업이라면 image-to-video나 reference-to-video에서 이미지로 시작하십시오. 한도가 2,500자이므로 줄여야 한다면 동작보다 형용사를 먼저 줄이십시오.
테이크를 비교하기 전에 화면 정하기
기본값은 16:9와 5초입니다. 납품물이 4:5나 9:21이라면 첫 초안 전에 설정하십시오. 한 화면에 맞춰 쓴 구도는 다른 화면으로 그대로 옮겨지지 않습니다. 움직임은 고른 길이 안에서 끝나도록 하고, 글만으로 쓴 샷은 의상, 체형, 프레이밍이 모델에 맡겨져 재실행마다 흔들린다는 점도 기억하십시오.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_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",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
