소개
MiniMax H3 Lite 참조 영상 생성 API는 이미지, 영상, 오디오를 참고해 480p 또는 768p의 사운드가 있는 4~15초 클립을 생성합니다. 프롬프트에서 이미지, 클립, 목소리를 하나씩 지목하고, 시리즈를 짜기 전에 인물 구성이 무너지지 않는지 확인합니다. 경량 설계로 아이디어를 시험하고 여러 버전을 생성하기에 적합합니다. 요청 한 번에 MP4 한 개가 나오며, 화면과 소리가 함께 만들어집니다.
시작 자료에 따라 모드 고르기
| 가진 것 | 모드 |
|---|---|
| 아이디어만 있음 | MiniMax H3 Lite 텍스트에서 영상 |
| 움직일 프레임(선택적으로 마지막 프레임) | MiniMax H3 Lite 이미지에서 영상 |
| 인물, 의상, 장소, 움직임 클립 또는 목소리 | MiniMax H3 Lite 참조에서 영상 |
핵심 기능 및 하이라이트
참조는 최대 15개
MiniMax H3 Lite는 한 번의 요청에서 이미지 최대 9장, 영상 클립 3개(총 15초), 오디오 클립 3개를 받습니다. 인물, 의상, 공간, 움직임, 목소리는 파일마다 다른 역할을 맡길 수 있습니다.
프롬프트에서 이름 붙이기
‘Image 1의 여자’, ‘Video 1의 움직임’, ‘Audio 1의 목소리’ 형태로 지목하세요. 번호는 각 목록에 나열한 순서와 같습니다.
입력에 따라 따르는 요금
이미지 5장까지는 요금에 포함되고, 초과분은 한 장마다 소액이 더해집니다. 참조 영상의 초는 출력의 초와 같은 방식으로 계산되고, 오디오는 무료입니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수, 1~7,000자. 더 긴 프롬프트는 거부됩니다. 1자 이상 · 7000자 이하 |
reference_image_urls | 아니요 | 최대 9장. 프롬프트에서 쓸 순서대로 이미지에 번호를 매기세요(Image 1, Image 2…). 1개 이상 · 9개 이하 |
reference_video_urls | 아니요 | 최대 3개. 각 2~15초, 총 15초까지. 1개 이상 · 3개 이하 |
reference_audio_urls | 아니요 | 목소리나 소리를 정하는 WAV 또는 MP3를 최대 3개까지 무료로 쓸 수 있습니다. 무료입니다. 1개 이상 · 3개 이하 |
aspect_ratio | 아니요 | 16:9(기본값), 9:16, 1:1, 4:3, 3:4, 21:9 중에서 고릅니다. 가격은 바뀌지 않습니다. |
resolution | 아니요 |
|
duration_seconds | 아니요 | 정수 초, 4~15, 기본값 5. 이 초 수와 해상도의 조합으로 1초당 요금이 정해집니다. |
요금
요금은 출력 1초 단위로 청구되며, 선택한 해상도에 따라 정해집니다. 참조 영상의 초도 출력 초와 같은 방식으로 셉니다. 참조 이미지는 5장까지 포함되며, 그 이상은 한 장마다 소액이 더해집니다. 오디오는 무료입니다. 현재 요금은 언제나 모델 페이지에 표시됩니다.
| 사양 | 요금 |
|---|---|
| $0.025 / 초 |
| $0.04 / 초 |
활용 사례
여러 파일로 조립하는 장면
인물, 의상 사진, 방 사진을 이미지 세 장으로 보내면, MiniMax H3 Lite가 그 사람을 그 옷차림으로 그 장소에 놓습니다. 등장인물이 말한다면 목소리 클립을 Audio 1로 더하세요.
여러 클립에 걸친 같은 캐릭터
매 요청마다 같은 인물 사진을 Image 1로 보내면, 장면이 바뀌어도 MiniMax H3 Lite가 얼굴과 의상을 유지합니다. 같은 인물이나 버추얼 진행자를 시리즈 내내 알아볼 수 있게 유지하는 용도로 쓸 수 있습니다.
움직임 따라 하기
짧은 클립을 Video 1로 넘기고 Image 1의 인물이 같은 동작을 하도록 요청할 수 있습니다. 춤, 몸짓, 카메라워크를 재현하는 데 알맞습니다. 참조 클립은 짧고 깔끔할수록 움직임이 잘 읽히고, 그 초만큼의 요금도 줄어듭니다. 그 초 수만큼 과금되기 때문입니다.
프롬프트 가이드 및 실전 팁
참조마다 역할은 하나씩
각 파일에 분명한 역할을 주세요. 얼굴, 의상, 공간, 움직임, 목소리 중 무엇인지 정하고, 그 역할을 프롬프트에 분명히 씁니다. 한 장에 역할이 여러 개 섞이면 결과가 불안정하므로, 단체 사진보다 얼굴만 잘라 낸 이미지가 더 잘 맞습니다.
오디오에는 이미지가 필요합니다
오디오 클립은 단독 참조가 될 수 없습니다. 이미지나 영상을 하나 이상 보내고, 말하는 내용은 프롬프트에 ‘ ’로 묶어 적으세요. 오디오는 목소리의 음색을, 프롬프트는 무슨 말을 누가 하는지를 정합니다.
참조 영상은 먼저 자르기
클립은 각 2~15초, 총 15초에 맞춰지며 그 초 수는 출력과 같이 과금됩니다. 보내기 전에 원하는 움직임이 보이는 부분만 남기세요.
요금은 출력 1초 단위로 청구되며, 선택한 해상도에 따라 정해집니다. 참조 영상의 초도 출력 초와 같은 방식으로 셉니다. 참조 이미지는 5장까지 포함되며, 그 이상은 한 장마다 소액이 더해집니다. 오디오는 무료입니다. 현재 요금은 언제나 모델 페이지에 표시됩니다.
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/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p",
"reference_image_urls": [
"https://example.com/reference.png"
]
}
}'
# 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 레퍼런스에서 확인하세요.
