소개
MiniMax는 2025년 10월 28일 Hailuo 02의 다음 단계로 Hailuo 2.3을 가벼운 Hailuo 2.3 Fast와 함께 공개했습니다. 이 엔드포인트는 두 모델을 이미지 투 비디오로 제공합니다. 샷이 시작될 프레임을 올리고 다음에 일어날 일을 적으면 무음 MP4가 돌아옵니다. generation_mode만 바꾸면 요청의 나머지는 그대로 둔 채 전체 모델과 Fast 버전을 고를 수 있습니다.
핵심 기능 및 하이라이트
물리적으로 보이는 움직임
MiniMax는 2.3을 매끄러운 몸동작, 카메라 움직임에 대한 안정적인 반응, 설득력 있는 빛과 그림자를 중심으로 다듬었습니다. 1080p 테스트에서 회전을 마친 댄서의 빨간 실크 드레스는 멈춘 뒤에도 흔들렸고, 치맛단은 굳지 않고 자연스럽게 가라앉았습니다.
서서히 변하는 표정
이번 릴리스의 또 다른 핵심은 미세한 표정 변화입니다. 무표정으로 시작한 클립이 6초 안에 시선, 숨결, 미소로 넘어갈 수 있습니다. 비 오는 창가 테스트에서는 카메라가 다가가는 동안 미소가 천천히 번집니다.
두 모델, 같은 요청 형식
standard와 fast는 같은 이미지, 프롬프트, 해상도, 길이를 받으므로 Fast로 초안을 잡은 샷을 다시 쓰지 않고 standard로 렌더링할 수 있습니다. 출력은 첫 이미지 비율을 따르며, 16:9 정지 이미지는 1364×768, 초당 24프레임으로 나왔습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 첫 프레임 이후의 동작과 카메라 움직임을 최대 5,000자로 적습니다. Hailuo 2.3은 무음이라 대사는 소리로 나오지 않습니다. 1자 이상 · 5000자 이하 |
image_url | 예 | 필수 첫 프레임이며 JPEG, PNG, WebP 형식으로 10MB까지 받습니다. 클립은 이 이미지의 비율을 유지합니다. |
generation_mode | 아니요 | standard(기본값)는 Hailuo 2.3, fast는 Hailuo 2.3 Fast를 사용합니다. fast는 더 빨리 끝나고 클립당 비용이 낮습니다. |
resolution | 아니요 | 768p(기본값) 또는 1080p. 1080p는 더 비싸고 6초 클립만 가능합니다. |
duration_seconds | 아니요 | 6초(기본값) 또는 10초. 10초는 768p에서만 되며 클립당 비용이 높습니다. |
요금
모드(standard 또는 fast), 해상도, 길이에 따라 클립 단위로 과금합니다. MiniMax가 거부하거나 실패한 요청은 과금하지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.163 / 요청 |
| $0.256 / 요청 |
활용 사례
움직이는 키 아트
캠페인 스틸, 커버 아트, 포스터 사진에 SNS와 티저용 짧은 움직이는 버전을 더합니다. 모델은 정확히 그 이미지에서 움직이기 시작하므로, 클립의 첫 1초에 맞춰 정지 이미지의 조명을 잡으세요.
댄스, 패션, 옷감
회전, 걷기, 몸 주변에서 움직이는 옷은 이 모델이 가장 잘 다루는 소재입니다. 이미 움직이는 프레임에서 시작하고 동작이 어떻게 끝나는지 적으면 클립에 착지점이 생깁니다.
대량 초안 릴
한 장면의 변형이 많이 필요할 때는 Fast 768p로 렌더링해 비교하고, 실제로 내보낼 한 편에만 standard 모드나 1080p를 쓰세요.
프롬프트 가이드 및 실전 팁
동작 하나, 그다음 카메라
프롬프트는 짧은 샷 설명처럼 씁니다. 누가 움직이는지, 무엇을 하는지, 어떻게 끝나는지, 카메라가 무엇을 하는지. 예를 들어 여성이 창가에서 돌아서고 머리카락을 귀 뒤로 넘긴 뒤 카메라가 다가가는 동안 미소 짓게 합니다. 6초 안에 서로 무관한 동작을 여러 개 넣으면 뒤섞이기 쉽습니다.
올린 프레임을 존중하기
첫 이미지가 의상, 조명, 구도를 정합니다. 첫 프레임에 없는 새 옷이나 장소를 요구하기보다 돌아보기, 한 걸음 내딛기, 바람 같은 그 이미지에서 자랄 수 있는 변화를 적으세요.
길이와 해상도는 함께 정하기
10초 클립은 768p에서만, 1080p는 6초만 됩니다. 요청은 노골적이기보다 암시적인 선에서 유지하세요. MiniMax는 프롬프트와 완성된 클립을 검수하며, 노골적인 표현은 즉시 거부되고 노출이 더 많은 쪽으로 흘러간 장면은 몇 분 뒤 실패할 수 있습니다. 이런 요청은 모두 과금되지 않습니다.
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/hailuo-2.3/image-to-video",
"input": {
"duration_seconds": 6,
"generation_mode": "standard",
"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 레퍼런스에서 확인하세요.























