소개
MiniMax H3 Max 텍스트→영상은 작성한 프롬프트를 480p 또는 768p, 5~15초 정수 길이의 클립으로 바꾸며, 앰비언스와 폴리, 음악도 같은 과정에서 생성합니다. MiniMax는 H3 Max를 H3의 빠른 생성 버전으로 소개합니다. 첫 실행 전에 알아 둘 기본값이 두 가지 있습니다. 화면비 기본값은 1:1, 길이 기본값은 8초이므로 납품 형식이 정해져 있다면 둘 다 명시하십시오.
시작 자료에 따라 모드 선택하기
| 시작 자료 | 모드 |
|---|---|
| 승인된 시작 이미지 | MiniMax H3 Max 이미지→영상 |
| 작성한 장면이나 스크립트 | MiniMax H3 Max 텍스트→영상 |
핵심 기능 및 하이라이트
6가지 화면비, 기본은 정사각형
aspect_ratio는 21:9, 16:9, 4:3, 1:1, 3:4, 9:16을 받으며 기본값은 1:1입니다. 이 항목 없이 와이드 브리프를 보내면 정사각형으로 돌아옵니다. snow-train-window-hands 예시는 21:9를 전제로 만들어졌습니다. 기차가 화면을 가로지르는 동안 객차 유리 양쪽에서 두 손이 맞닿는 구도로, 더 정사각형에 가깝게 자르면 성립하지 않습니다.
초안은 480p, 최종본은 768p
resolution은 480p와 768p 중에서 고르며 기본값은 768p입니다. 720p, 1080p, 4K 옵션은 없으며, 이런 값은 요청이 대기열에 들어가기 전에 스키마가 거부합니다. 480p는 초당 요금이 더 낮아 문구, 길이, 구도를 시험하는 단계에 맞고, 남길 테이크는 768p로 렌더링하면 됩니다.
프롬프트 확장은 선택 사항
enable_prompt_expansion은 기본값이 꺼짐이라 프롬프트가 쓴 그대로 렌더링됩니다. 켜면 MiniMax가 먼저 짧은 브리프를 샷, 소리, 음악까지 담은 더 자세한 묘사로 확장하므로 쓰지 않은 세부가 더해질 수 있고, 요청은 프롬프트 확장 요금으로 청구됩니다. 공개 예시는 구체적으로 써서 이를 막습니다. night-train-beckon 프롬프트는 초록 벨벳, 광택 나는 황동, 버얼 월넛, 독서등 하나, 그리고 카메라가 따라가야 할 정확한 몸짓까지 이름을 붙여 적습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 한 컷처럼 쓰세요. 피사체, 움직임, 카메라, 빛, 소리를 일어나는 순서대로 적으면 됩니다. 1자 이상 · 7000자 이하 |
aspect_ratio | 아니요 | 기본값은 1:1입니다. 아나모픽은 21:9, 세로는 9:16으로 지정하세요. |
duration_seconds | 아니요 | 정수 초로 5에서 15까지입니다. 생략하면 5가 아니라 8이 됩니다. |
resolution | 아니요 | 480p 또는 768p이며 기본값은 768p입니다. 둘 다 네이티브 렌더링이고 480p가 초당 더 저렴합니다. |
enable_prompt_expansion | 아니요 | 기본값은 꺼짐이라 프롬프트가 쓴 그대로 사용됩니다. 켜면 MiniMax가 먼저 프롬프트를 샷, 소리, 음악까지 담은 더 자세하고 구조화된 묘사로 확장한 뒤 그것을 바탕으로 렌더링합니다. 기본값: |
요금
| 사양 | 요금 |
|---|---|
| $0.05 / 초 |
| $0.08 / 초 |
활용 사례
패션과 캠페인 영상
silver-corridor 예시는 한 문단으로 만든 캠페인풍 샷입니다. 강한 림 라이트를 받는 액체 같은 은빛 가운, 윈드 머신에 날리는 머리카락, 마지막에 렌즈를 똑바로 보는 시선이 21:9, 5초에 담기고, 오디오에는 낮은 신스 드론이 흐릅니다. 원단의 움직임, 빛, 마지막 시선은 모두 글로 썼으며 이미지로 준 것은 없습니다.
이름으로 요청하는 시대의 룩
필름 질감은 직접 요청할 수 있습니다. roller-rink 예시는 강한 헐레이션, 바랜 색, 두꺼운 그레인, 약간의 게이트 흔들림이 있는 1970년대 룩을 요청하고, 두 단계 동작을 5초에 넣습니다. 링크를 천천히 한 바퀴 돌고, 두 팔을 벌린 채 뒤로 미끄러지며 카메라 쪽으로 다가옵니다.
소재와 빛 검토
여러 표면이 움직이는 빛에 반응하는 장면은 글 브리프에 잘 맞습니다. night-train-beckon에서는 카메라가 아주 얕은 심도로 다가가는 동안 플랫폼 불빛이 얼굴, 새틴, 다리 위로 빛줄기를 쓸고 지나갑니다. image-to-video용 시작 프레임을 만들기 전에 조명 아이디어가 읽히는지 이런 브리프로 확인하십시오.
프롬프트 가이드 및 실전 팁
시간 순서대로 샷 쓰기
피사체, 움직임, 카메라, 빛, 소리를 일어나는 순서대로 나열합니다. silver-corridor 프롬프트는 첫걸음부터 마지막 시선까지 샷을 차례로 따라간 다음 화질(‘anamorphic 2.39:1, deep blacks, glossy specular highlights’)을 더하고, 소리(‘low synth drone’)로 마무리합니다.
동작만이 아니라 경계도 쓰기
확장을 켠다면 일어나야 할 일과 함께 바뀌면 안 되는 것도 적습니다. night-train-beckon 프롬프트는 분명한 제약으로 끝납니다. 슬립 나이트드레스와 스타킹은 끝까지 입은 채이고, 글자나 로고, 다른 인물은 화면에 없다는 내용입니다. 글만으로는 의상, 체형, 프레이밍이 모델에 맡겨지므로, 적어 두지 않으면 연속 실행 결과가 흔들립니다.
문자 그대로의 결과가 필요하면 image-to-video로
아이디어는 맞는데 피사체가 디자인과 다르다면 스틸을 생성하거나 골라 image-to-video로 옮기십시오. 시작 프레임은 같은 내용을 프롬프트로 쓸 때보다 훨씬 충실히 반영됩니다. 길이도 의도적으로 정하십시오. 생략하면 5초가 아니라 8초가 됩니다.
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-max/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p",
"aspect_ratio": "1:1",
"duration_seconds": 8,
"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 레퍼런스에서 확인하세요.
