소개
MiniMax H3 텍스트→영상은 이미지나 참조 세트 없이 프롬프트만으로 클립을 생성합니다. 길이는 5~15초의 정수, 해상도는 768p·2k, 화면비는 6가지 중에서 고르며, 사운드는 영상과 같은 과정에서 함께 생성됩니다. 프롬프트 칸에는 최대 7,000자까지 들어가므로 캡션이 아니라 샷 전체를 서술할 수 있습니다.
시작 자료에 따라 모드 선택하기
| 시작 자료 | 모드 |
|---|---|
| 작성한 장면이나 스크립트 | MiniMax H3 텍스트→영상 |
| 승인된 시작 이미지 | MiniMax H3 이미지→영상 |
| 참조 이미지 1~9장 | MiniMax H3 참조→영상 |
핵심 기능 및 하이라이트
요청마다 고르는 6가지 화면비
aspect_ratio는 16:9(기본값), 9:16, 1:1, 4:3, 3:4, 21:9를 받습니다. 21:9는 아나모픽 레터박스로 출력되며, 공개 예시 noir-window가 이 비율로 만들어졌습니다. 붉은 네온의 깜박임, 블라인드 그림자, 천천히 돌아보는 얼굴까지 모두 와이드 화면을 전제로 한 문단에 적혀 있습니다. 쓰기 전에 비율을 정하고, 그 화면에 맞춰 피사체를 배치하십시오.
같은 브리프로 연출하는 사운드
오디오는 나중에 입히는 것이 아니라 영상과 함께 생성되므로, 사운드트랙도 프롬프트에서 지시합니다. 룸톤, 폴리, 음악, 대사를 모두 적을 수 있습니다. thunder-wheat-field 예시에서는 천둥소리가 번개와 같은 파일에 담겨 돌아오기 때문에, 편집에서 번개에 맞춰 소리를 자를 필요가 없습니다.
768p·2k 모두 네이티브
두 해상도는 모두 네이티브 출력이며 480p와 720p는 선택할 수 없습니다(스키마가 거부합니다). 길이와 해상도 모두 가격에 반영되므로, 동작과 구도가 잡힐 때까지 768p로 시험하고 채택할 테이크를 2k로 생성하는 것이 기본 흐름입니다. 이 엔드포인트는 seed를 받지 않으므로 2k 실행은 초안을 선명하게 만든 것이 아니라 같은 브리프에서 나온 새 테이크입니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 한 컷처럼 쓰세요. 피사체, 동작, 카메라 무빙, 빛, 소리 순서로 적으세요. 1자 이상 · 7000자 이하 |
aspect_ratio | 아니요 | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 중에서 고릅니다. 21:9가 아나모픽 레터박스입니다. |
resolution | 아니요 | 768p 또는 2k이고 둘 다 네이티브 출력입니다. 초안은 768p로, 납품은 2k로 뽑으세요. |
duration_seconds | 아니요 | 정수 초로 5에서 15까지입니다. 가격을 좌우합니다. |
요금
| 사양 | 요금 |
|---|---|
| $0.037 / 초 |
| $0.058 / 초 |
활용 사례
아이디어만으로 샷 시작하기
text-to-video는 H3에서 이미지 입력이 필요 없는 엔드포인트입니다. curtain-silhouette 예시는 다시 실행해도 결과가 잘 유지되는 브리프의 전형입니다. 고정 카메라, 얇은 커튼, 그 뒤의 따뜻한 램프 하나, 그리고 윤곽만 읽히는 실루엣으로 구성됩니다. 열어 둔 요소가 적을수록 연속으로 생성한 테이크끼리 가까워집니다.
조명과 타이밍 아이디어 시험하기
시간에 따라 변하는 빛은 모두 프롬프트로 씁니다. thunder-wheat-field 브리프는 간헐적인 노출을 요구하며, 번개가 칠 때마다 흠뻑 젖은 셔츠가 순간 하얗게 드러났다가 다시 어둠으로 돌아갑니다. 조건은 16:9, 768p, 6초입니다. 이런 짧은 초안으로 효과가 읽히는지 확인한 뒤 2k로 생성하십시오.
다른 모드로 이어지는 시퀀스의 시작점 만들기
H3에는 편집 엔드포인트가 없고, 한 요청의 상한은 15초입니다. 긴 장면이 필요하면 첫 샷을 여기서 생성하고 MiniMax H3 비디오 연장으로 이어 가십시오. 승인한 클립의 마지막 프레임에서 다음 샷을 시작하고, 둘을 이어 붙인 파일 하나로 돌려줍니다. 피사체를 디자인한 그대로 보여야 할 때는 대신 image-to-video로 전환하십시오. 글만으로는 의상, 체형, 프레이밍이 모델에 맡겨져 연속 실행 결과가 흔들리기 때문입니다.
프롬프트 가이드 및 실전 팁
일어나는 순서대로 샷 쓰기
프롬프트는 피사체, 동작, 카메라, 빛, 소리 순서로 구성합니다. noir-window 프롬프트를 그대로 틀로 쓸 수 있습니다. 창턱에 누가 있고 무엇을 입었는지, 무엇을 하는지(연기를 내뿜고 천천히 카메라 쪽으로 고개를 돌림), 다음으로 룩(블라인드 그림자, 깊은 검정, 1970년대 그레인), 마지막으로 소리(빗소리와 먼 차량 소음)입니다.
두 피사체에는 카메라 움직임 하나
한 화면에 두 요소를 동시에 담아야 할 때는 둘 다에 도움이 되는 움직임 하나만 카메라에 줍니다. mirror-two-views 예시는 오른쪽으로 천천히 도는 아크를 지시해 여성의 등과 앤티크 거울에 비친 앞모습을 함께 보여 줍니다. 같은 프롬프트는 의상이 끝까지 그대로라고도 분명히 적습니다. 의상이 그대로 유지되어야 하는 샷이라면 암시에 맡기지 말고 적어 두십시오.
실행마다 한 가지만 바꾸기
seed가 없으므로 같은 설정으로 두 번 실행하면 서로 다른 테이크가 나옵니다. 테이크를 비교하는 동안에는 문구를 고정하고, 결과가 빗나가면 카메라 지시나 조명 문장처럼 한 요소만 바꾸며 브리프 전체를 다시 쓰지 않습니다. 피사체와 구도가 매번 같아야 한다면 image-to-video의 시작 프레임으로 고정하십시오.
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/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,
"enable_prompt_expansion": false
}
}'
# 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 레퍼런스에서 확인하세요.
