소개
HappyHorse 1.1 이미지→영상은 image_url로 보낸 시작 프레임을 움직입니다. 프롬프트는 필수이며 뒤이어 일어날 움직임을 적습니다. 클립은 720p 또는 1080p, 3~15초 정수 길이이며 생성된 사운드트랙이 붙습니다. 화면비 항목도 마지막 프레임 항목도 없습니다. 화면 모양은 스틸이 정하고, 끝은 프롬프트로 지시한 움직임이 도달하는 곳이 됩니다.
시작 자료에 따라 모드 선택하기
| 시작 자료 | 모드 |
|---|---|
| 작성한 장면이나 스크립트 | HappyHorse 1.1 텍스트→영상 |
| 승인된 시작 이미지 | HappyHorse 1.1 이미지→영상 |
| 참조 이미지 1~9장 | HappyHorse 1.1 참조→영상 |
핵심 기능 및 하이라이트
피사체와 화면 모양은 스틸이 정합니다
시작 프레임을 충실히 따르므로, 무검열 원본 프레임을 포함해 문자 그대로의 결과를 얻는 확실한 경로입니다. tailgate-turn 예시에서 의상, 트럭, 역광은 모두 프레임에서 오며, 프롬프트는 병을 내리고 부츠를 한 번 흔든 뒤 낮은 해 쪽으로 고개를 돌리라고만 요청합니다.
겨냥할 마지막 프레임이 없습니다
이 엔드포인트는 image_url 하나만 받으므로 샷을 마지막 구도에 고정할 수 없습니다. 스스로 마무리되는 움직임이 가장 잘 맞습니다. quiet-hold 예시는 거의 정지한 4초입니다. 숨을 내쉬고, 어깨를 떨어뜨리고, 창틀에 기대 무게를 옮기는 것이 전부이며 카메라는 거의 움직이지 않습니다.
입력과 출력 조건
시작 프레임은 각 변 300px 이상, 화면비 1:2.52.5:1, 파일 크기 20MB 이하여야 합니다. 출력은 315초이고 기본값은 5초이며, 해상도는 720p(기본값) 또는 1080p이고 사운드트랙은 항상 영상과 함께 생성됩니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수입니다. 프레임 다음에 달라지는 것을 적으세요. 1자 이상 · 2500자 이하 |
image_url | 예 | 첫 프레임입니다. 피사체와 구도를 고정하고 출력 형태도 정합니다. |
resolution | 아니요 | 720p와 1080p 중에서 고릅니다. |
duration_seconds | 아니요 | 정수 초로 3에서 15까지입니다. 마지막 프레임이 없으니 그 시간 안에 마무리될 동작으로 두세요. |
seed | 아니요 | 무작위 출발점을 정하는 0에서 2147483647까지의 정수입니다. 빼면 실행마다 각자 값을 뽑습니다. |
요금
| 사양 | 요금 |
|---|---|
| $0.14 / 초 |
| $0.18 / 초 |
활용 사례
무검열 프레임이나 공들인 프레임 움직이기
이 경로는 받은 프레임을 따르므로, 무검열 작업은 허용 범위를 넘는 프롬프트를 거부하는 text-to-video가 아니라 여기서 시작합니다. 디자인한 프레임을 보내고 움직임만 쓰십시오. 피사체는 문장에서 다시 해석되지 않고 그리거나 찍은 모습 그대로 나타납니다.
유지한 포즈 주변의 환경 움직임
wasteland-hood-two 예시는 멈춘 자동차 보닛 위의 두 인물을 그대로 두고, 움직이는 것만 적습니다. 바람에 들렸다 떨어지는 찢어진 천, 일렁이는 아지랑이, 도로를 가로지르는 회오리 먼지, 그리고 천천히 다가가는 푸시인입니다. 1080p, 기본 길이로 생성되었습니다.
짧은 인서트와 컷어웨이
카메라 움직임이 거의 없는 3~4초 클립은 긴 샷 사이에 끼우는 인서트에 알맞습니다. quiet-hold처럼 동작을 숨 한 번이나 몸짓 하나로 제한하면, 도중에 끊기지 않고 길이 안에서 움직임이 끝납니다.
프롬프트 가이드 및 실전 팁
프롬프트에는 움직임만
프롬프트는 필수이므로 변하는 것, 즉 동작, 카메라, 템포에 쓰십시오. wasteland-hood-two 프롬프트는 구도를 전혀 묘사하지 않고 바람, 아지랑이, 먼지를 묘사합니다. 프레임을 다시 묘사하면 이미지가 이미 고정한 것에 2,500자 한도를 쓰게 됩니다.
움직임 크기를 길이에 맞추기
마지막 프레임이 없으므로, 고른 시간 안에 끝나지 않는 움직임은 클립이 끝나는 곳에서 그냥 멈춥니다. 동작을 길이에 맞추십시오. 짧은 클립에는 몸짓 하나, 긴 클립에는 tailgate-turn이 6초 동안 보여 주는 ‘내리기, 흔들기, 돌아보기’ 같은 짧은 연속 동작이 알맞습니다.
업로드 전에 자르기
출력 모양은 스틸이 정하므로 먼저 납품용 화면비로 자르고 크기 조건도 확인하십시오. 720p로 초안을 만들고 납품용으로 1080p에서 다시 실행하십시오. 실행마다 새 테이크가 나오므로 비교하는 동안에는 문구를 고정하십시오.
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/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# 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 레퍼런스에서 확인하세요.
