소개
MiniMax H3 Max 이미지→영상은 image_url로 보낸 시작 프레임을 480p 또는 768p, 5~15초 정수 길이의 클립으로 움직이며, 사운드도 같은 과정에서 생성합니다. 선택 항목인 last_image_url로 마지막 프레임까지 고정할 수 있습니다. 출력 모양은 시작 프레임이 정하고, 길이를 지정하지 않은 요청은 8초로 실행됩니다.
시작 자료에 따라 모드 선택하기
| 시작 자료 | 모드 |
|---|---|
| 승인된 시작 이미지 | MiniMax H3 Max 이미지→영상 |
| 작성한 장면이나 스크립트 | MiniMax H3 Max 텍스트→영상 |
핵심 기능 및 하이라이트
피사체·의상·화면 모양은 프레임이 정합니다
이 엔드포인트에는 화면비 항목이 없으며, 넘겨준 스틸이 클립의 프레임을 결정합니다. laundromat-spin 예시에서는 공간, 의상, 밋밋한 형광등 빛에 관해 아무것도 적지 않았습니다. 시작 프레임이 모두 정해 두었기 때문입니다. 프롬프트는 세탁기가 탈수에 들어가는 움직임과 그녀의 반응만 묘사합니다.
샷의 양 끝 고정하기
last_image_url은 마지막 프레임을 더하는 항목이며 image_url과 함께일 때만 보낼 수 있습니다. frame-to-frame 예시는 8초 동안 한 구도에서 다른 구도로 착지하므로 편집에서 깔끔하게 붙습니다. 마지막 프레임이 묶는 것은 끝부분이지 중간이 아니며, 빛이나 의상이 어긋나는 두 프레임을 주면 그 사이에서 타협하는 움직임이 눈에 띄게 나타납니다.
최소 5초, 해상도는 두 가지
길이는 5~15초의 정수이고 기본값은 8초입니다. resolution은 480p와 768p 중에서 고르며 기본값은 768p이고, 480p가 초당 더 저렴해 초안에 알맞습니다. 가장 짧은 요청도 이미 완결된 한 박자이며, laundromat-spin 클립은 탈수, 웃음, 다리 흔들기, 드럼을 향한 시선까지 5초에 담습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 첫 프레임입니다. 피사체와 의상, 구도를 고정하고 출력 형태까지 정합니다. |
last_image_url | 아니요 | 선택인 마지막 프레임입니다. image_url과 함께일 때만 유효하고, 중간이 아니라 결말을 제한합니다. |
prompt | 예 | 첫 프레임 다음에 달라지는 동작과 카메라, 소리를 적으세요. 프레임 자체를 적지는 마세요. 1자 이상 · 7000자 이하 |
duration_seconds | 아니요 | 정수 초로 5에서 15까지입니다. 생략하면 8초가 됩니다. |
resolution | 아니요 | 480p 또는 768p이며 기본값은 768p입니다. 둘 다 네이티브 렌더링이고 480p가 초당 더 저렴합니다. |
enable_prompt_expansion | 아니요 | 기본값은 꺼짐이라 프롬프트가 쓴 그대로 사용됩니다. 켜면 MiniMax가 먼저 프롬프트를 샷, 소리, 음악까지 담은 더 자세하고 구조화된 묘사로 확장한 뒤 그것을 바탕으로 렌더링합니다. 기본값: |
요금
| 사양 | 요금 |
|---|---|
| $0.05 / 초 |
| $0.08 / 초 |
활용 사례
사물에서 인물로 틸트하기
끊김 없는 카메라 움직임 하나로 가면, 무엇을 어떤 순서로 드러낼지가 브리프의 전부가 됩니다. grimoire-to-bare-shoulder 예시는 펼쳐진 마법서에서 시작해 등받이 높은 의자에 앉은 독자에게로 틸트하며, 책장에서 나온 인장 빛이 8초 동안 그녀의 어깨 위를 지나갑니다. 시작 구도는 이미지가 고정하므로 프롬프트는 카메라가 무엇을 언제 발견하는지에 단어를 씁니다.
정해진 구도로 클립 끝내기
편집상 특정 프레임에서 끝나야 한다면 두 프레임을 모두 보냅니다. 마지막 스틸은 시작 프레임의 연장선으로 준비하고, 둘을 잇는 동작을 씁니다. frame-to-frame에서 그 동작은 대리석 복도를 따라 카메라 쪽으로 걸어와 렌즈를 똑바로 보며 멈추는 것이고, 강한 림 라이트와 윈드 머신, 낮은 신스 드론이 함께합니다.
고정 카메라 장면에 생기 불어넣기
고정된 와이드 샷에도 작은 움직임을 여럿 동시에 담을 수 있습니다. laundromat-spin 프롬프트는 고정 카메라, 유리 너머로 도는 드럼, 한 번 깜박이는 형광등, 그리고 인물의 반응을 요청하며, 오디오에는 조용한 기계음이 깔립니다.
프롬프트 가이드 및 실전 팁
프레임이 아니라 변화를 쓰기
시작 프레임 이후에 일어나는 일을 쓰고 외형은 이미지에 맡깁니다. ‘The washing machine under her shudders into its spin cycle and she bounces slightly with it’는 움직임만 가리키며, 스틸에 이미 보이는 것은 하나도 반복하지 않습니다. 프레임에 보이는 것을 설명하는 구절이 있다면 지우십시오.
중요한 세부는 모두 적기
프롬프트 확장은 기본값이 꺼짐이라 프롬프트가 쓴 그대로 사용됩니다. enable_prompt_expansion을 켜면 MiniMax가 먼저 샷, 소리, 음악까지 담은 더 자세한 묘사로 확장하므로 적지 않은 세부가 덧붙을 수 있고, 요청은 프롬프트 확장 요금으로 청구됩니다. 카메라 움직임(‘slow tilt, no cut’), 광원, 소리를 분명히 적고, 한 번 실행할 때 한 가지만 바꿔 각 변경의 효과를 확인하십시오.
업로드 전에 자르고 두 프레임 맞추기
출력은 시작 스틸의 모양을 따르므로 납품 형태로 잘라 두십시오. 마지막 프레임을 더할 때는 두 스틸 사이에서 피사체, 의상, 빛이 이어지게 하고, 이를 잇는 동작에 충분한 길이를 고르십시오. 15초 클립에서는 양 끝을 고정해도 중간이 흔들릴 수 있습니다.
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/image-to-video",
"input": {
"duration_seconds": 8,
"enable_prompt_expansion": false,
"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 레퍼런스에서 확인하세요.
