소개
MiniMax H3 Lite 텍스트 영상 생성 API는 480p 또는 768p로 사운드가 있는 4~15초 클립을 생성합니다. 장면을 한 번 쓴 뒤 한 번에 하나씩만 바꿔 다시 돌리면 어떤 테이크가 맞는지 알 수 있습니다. 경량 설계로 아이디어를 시험하고 여러 버전을 생성하기에 적합합니다. 요청 한 번에 MP4 한 개가 나오며, 화면과 소리가 함께 만들어집니다.
시작 자료에 따라 모드 고르기
| 가진 것 | 모드 |
|---|---|
| 아이디어만 있음 | MiniMax H3 Lite 텍스트에서 영상 |
| 움직일 프레임(선택적으로 마지막 프레임) | MiniMax H3 Lite 이미지에서 영상 |
| 인물, 의상, 장소, 움직임 클립 또는 목소리 | MiniMax H3 Lite 참조에서 영상 |
핵심 기능 및 하이라이트
한 번의 생성으로 소리와 대사
MiniMax H3 Lite의 클립은 모두 소리가 포함되어 반환됩니다. ‘ ’로 쓴 대사는 말로 전달되고, 음악이나 주변 소리는 장면에서 쓴 단어를 따라 나오므로 짧은 장면이라도 별도의 오디오 작업이 필요 없습니다.
가로세로 비율 6종
여섯 가지 비율의 요금이 같으므로, 하나의 아이디어를 가로형과 세로형으로 가격 차이 없이 시험할 수 있습니다.
두 가지 가격대
480p는 768p보다 초당 약 40% 저렴하므로, 최종 컷을 렌더링하기 전에 프롬프트를 탐색하는 저비용 방법입니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수, 1~7,000자. 더 긴 프롬프트는 거부됩니다. 1자 이상 · 7000자 이하 |
aspect_ratio | 아니요 | 16:9(기본값), 9:16, 1:1, 4:3, 3:4, 21:9 중에서 고릅니다. 가격은 바뀌지 않습니다. |
resolution | 아니요 |
|
duration_seconds | 아니요 | 정수 초, 4~15, 기본값 5. 이 초 수와 해상도의 조합으로 1초당 요금이 정해집니다. |
요금
요금은 출력 1초 단위로 청구되며, 선택한 해상도에 따라 정해집니다. 현재 요금은 언제나 모델 페이지에 표시됩니다.
| 사양 | 요금 |
|---|---|
| $0.025 / 초 |
| $0.04 / 초 |
활용 사례
스토리보드와 피치 클립
작성한 샷 리스트를 기획 발표나 대본 리딩 전에 보여 줄 수 있는 간단한 미리보기로 만듭니다. MiniMax H3 Lite의 각 프롬프트는 소리가 있는 완성 클립을 반환하므로, 장면을 눈으로만 보는 것이 아니라 소리까지 함께 확인할 수 있고, 비싼 작업을 하기 전에 약한 아이디어를 걸러 낼 수 있습니다.
대량 프롬프트 초안 작업
작가와 앱 개발자는 MiniMax H3 Lite에서 같은 장면의 여러 버전을 시도하고 잘 되는 것을 남길 수 있으며, 비용은 출력 초 단위로만 냅니다. 실행마다 카메라, 의상, 대사 중 하나만 바꾸면 어느 버전을 더 정교하게 렌더링할지 결과가 알려 줍니다.
대사가 있는 세로형 클립
5~8초짜리 9:16 장면에 인용 대사 한 줄과 주변 소리를 넣으면, MiniMax H3 Lite에서 바로 소셜 형식에 맞게 만들 수 있으며 별도의 소리 편집 과정이 필요 없습니다. 자주 올리는 경우 설정 하나를 고정하고 동작과 대사만 바꾸면, 480p 4초 초안은 한 편에 $0.10입니다.
프롬프트 가이드 및 실전 팁
장면을 순서대로 쓰기
누가 있는지, 먼저 무엇을 하고 이어서 무엇을 하는지, 카메라 위치를 순서대로 쓰고, 마지막에 소리를 정하는 Audio: 줄을 둡니다. 형용사를 늘어놓기보다 일어나는 순서대로 쓰는 편이 움직임이 매끄럽고, 골든아워나 네온처럼 빛의 종류를 적으면 분위기가 바로 정해집니다.
대사는 짧게
5~8초 클립이라면 따옴표로 묶은 대사는 한두 줄이 알맞습니다. 각 대사의 화자를 명시하면 올바른 인물의 입이 움직입니다. 긴 대사는 빨라지거나 중간에 끊기므로 여러 클립에 나누어 쓰세요.
저렴하게 초안을 만들고 선명하게 마무리하기
480p로 반복 작업하고, 남길 결과물은 같은 프롬프트로 768p에서 렌더링하세요. 구도는 거의 그대로 이어집니다.
요금은 출력 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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p",
"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 레퍼런스에서 확인하세요.
