소개
MiniMax H3 360 Orbit 이미지→영상은 사진 한 장을, 시간이 멈춘 순간 주위를 도는 360도 카메라 궤도로 바꾸고, 시작한 프레임에서 끝나게 합니다.
핵심 기능 및 하이라이트
- 사진 한 장을 넣으면 360도 전체 궤도 영상이 나옵니다. 사진이 첫 프레임과 마지막 프레임으로 함께 쓰이므로 클립은 시작한 자리로 돌아옵니다.
- 360 Orbit 어댑터는 강도 1로, 학습된 지시문 그대로 실행되므로 프롬프트를 쓸 필요가 없습니다.
- 어댑터가 없으면 같은 기본 모델은 시작과 끝이 같은 이미지를 정지 화면으로 읽어 거의 움직이지 않습니다.
- 출력은 사진의 비율을 유지합니다. 정사각형 사진이면 정사각형 영상이 나옵니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 궤도를 돌 사진입니다. 첫 프레임과 마지막 프레임으로 쓰여 영상이 루프됩니다. 1자 이상 |
resolution | 아니요 | 480p(기본), 540p, 768p 또는 1080p입니다. 해상도가 높을수록 초당 요금이 올라갑니다. |
duration_seconds | 아니요 | 3~6초(기본 3초)입니다. 3초는 깔끔하고 완전히 멈춘 한 바퀴입니다. |
seed | 아니요 | 여러 사진이나 길이를 시험할 때 실행끼리 비교할 수 있게 해 줍니다. 프레임까지 똑같은 영상을 보장하지는 않습니다. |
요금
출력 초당, 선택한 해상도 기준으로 과금됩니다.
| 사양 | 요금 |
|---|---|
| $0.05 / 초 |
| $0.075 / 초 |
| $0.10 / 초 |
| $0.20 / 초 |
활용 사례
- 멈춘 순간의 인물 사진: 카메라가 도는 동안 인물, 머리카락, 떠 있는 디테일이 그대로 멈춰 있습니다.
- 사진 한 장으로 패션과 코디를 모든 방향에서 보여 줍니다.
- 시작한 곳에서 정확히 끝나는, SNS 게시물용 짧은 루프 클립.
프롬프트 가이드 및 실전 팁
- 3초가 가장 깔끔하게 멈춥니다. 테스트에서 피사체, 머리카락, 공중에 떠 있는 꽃잎이 한 바퀴 내내 멈춰 있었습니다.
- 6초에서는 궤도가 느려지고 사람이 움직이기 시작할 수 있습니다. 테스트에서는 춤추던 두 사람이 움직이기 시작했습니다.
- 앞쪽이 붐비면 렌즈 앞을 가로지를 수 있습니다. 붐비는 과수원에서는 나무 기둥이 카메라와 피사체 사이를 잠깐씩 지나갔습니다.
- 클립이 가졌으면 하는 사진의 비율을 골라 주십시오.
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-360-orbit/image-to-video",
"input": {
"duration_seconds": 3,
"image_url": "https://example.com/reference.png",
"resolution": "480p"
}
}'
# 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 레퍼런스에서 확인하세요.
