소개
MiniMax H3 Lite 이미지 영상 생성 API는 정지 이미지 한 장을 480p 또는 768p의 사운드가 있는 4~15초 클립으로 만듭니다. 시작 프레임을 보내고 필요하면 마지막 프레임도 더해, 먼저 480p로 움직임을 확인한 뒤 선명한 렌더링으로 넘어갑니다. 경량 설계로 아이디어를 시험하고 여러 버전을 생성하기에 적합합니다. 요청 한 번에 MP4 한 개가 나오며, 화면과 소리가 함께 만들어집니다.
시작 자료에 따라 모드 고르기
| 가진 것 | 모드 |
|---|---|
| 아이디어만 있음 | MiniMax H3 Lite 텍스트에서 영상 |
| 움직일 프레임(선택적으로 마지막 프레임) | MiniMax H3 Lite 이미지에서 영상 |
| 인물, 의상, 장소, 움직임 클립 또는 목소리 | MiniMax H3 Lite 참조에서 영상 |
핵심 기능 및 하이라이트
프레임이 분위기를 정합니다
시작 프레임이 얼굴, 의상, 조명, 구도를 고정하므로 MiniMax H3 Lite는 프롬프트를 움직임에 쓸 수 있습니다. 클립은 프레임의 모양을 유지합니다. 클립은 보낸 프레임의 모양을 따르고 화면 비율 필드가 없으므로, 업로드 전에 가로형이나 세로형으로 잘라 주세요.
선택적인 마지막 프레임
두 번째 이미지를 last_image_url로 지정하면 클립이 그 이미지에서 끝납니다. 그러면 정지 이미지 두 장이 계획된 전환이 됩니다. 모델이 결말을 지어내지 않고 두 그림 사이의 움직임을 짜기 때문에, 한 장면을 다음 컷에 이어야 할 때 도움이 됩니다.
소리 포함
움직임에 맞는 소리가 따라옵니다. 파도 소리, 발소리, 웃음소리, 따옴표 대사가 그림과 함께 만들어지며 추가 요금은 없습니다. 장면이 떠올리게 하는 소리 대신 특정 음악 스타일이나 공간의 울림을 원하면 Audio: 줄을 더하세요.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수, 1~7,000자. 더 긴 프롬프트는 거부됩니다. 1자 이상 · 7000자 이하 |
image_url | 예 | 필수 시작 프레임. 클립은 그 모양을 유지합니다. |
last_image_url | 아니요 | 선택적 마지막 프레임. 클립은 이 프레임에서 멈춥니다. |
resolution | 아니요 |
|
duration_seconds | 아니요 | 정수 초, 4~15, 기본값 5. 이 초 수와 해상도의 조합으로 1초당 요금이 정해집니다. |
요금
요금은 출력 1초 단위로 청구되며, 선택한 해상도에 따라 정해집니다. 현재 요금은 언제나 모델 페이지에 표시됩니다.
| 사양 | 요금 |
|---|---|
| $0.025 / 초 |
| $0.04 / 초 |
활용 사례
움직이는 제품 사진과 패션 사진
재킷, 가방, 신발의 카탈로그 사진을 MiniMax H3 Lite에서 짧은 클립의 출발점으로 쓸 수 있습니다. 원본 촬영의 조명이 그대로 유지되고, 걷기, 돌아보기, 물건 집어 들기 같은 동작이 붙습니다. 간단한 동작이라면 다시 촬영하지 않아도 됩니다.
인물 사진에 생명 불어넣기
인물 사진 한 장이 MiniMax H3 Lite에서 자연스러운 움직임과 소리가 있는 짧은 클립이 됩니다. 겉모습을 처음부터 설명하지 않아도 됩니다. 미소 한 번, 고개 돌리기, 카메라 쪽으로 다가오기 같은 동작 하나만으로도 프로필 사진이나 캐릭터 카드에 생기가 돕니다.
통제된 전환
시작 프레임과 마지막 프레임을 함께 쓰면, MiniMax H3 Lite가 두 정지 이미지 사이의 움직임을 채웁니다. 전후 비교, 의상 변경, 캐릭터가 다른 자세로 끝나는 스토리 전환 등에 어울립니다.
프롬프트 가이드 및 실전 팁
그림이 아니라 다음 순간을 설명하기
프레임만 보아도 누가 어디에 있는지는 이미 알 수 있습니다. 프롬프트에는 그다음 동작, 카메라 이동, 소리를 일어나는 순서대로 적으세요. 그림을 다시 설명하면 움직임이 멈추기 쉽고, ‘그녀가 창 쪽으로 돌아본다’ 같은 첫 동작을 적으면 화면이 움직이기 시작합니다.
한계에 맞는 프레임 쓰기
크기 조건은 한 변 2565,760픽셀, 가로 대 세로 비율 0.42.5여야 합니다. 극단적인 파노라마 이미지는 보내기 전에 자르세요. 피사체가 또렷하게 보이는 밝은 이미지가 작거나 압축이 심한 이미지보다 얼굴이 안정적입니다.
어울리는 프레임끼리 짝짓기
마지막 프레임은 시작 프레임과 같은 인물과 공간을 보여 주면서, 새 포즈, 한 걸음 가까이 다가가기, 다른 표정처럼 프롬프트로 설명할 수 있는 변화가 있을 때 가장 잘 작동합니다. 관련 없는 두 그림은 컷처럼 튀는 움직임을 만듭니다.
요금은 출력 1초 단위로 청구되며, 선택한 해상도에 따라 정해집니다. 현재 요금은 언제나 모델 페이지에 표시됩니다.
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": "minimax/h3-lite/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": "768p"
}
}'
# 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 레퍼런스에서 확인하세요.
