MiniMax H3
공유 AI 비디오 생성 엔드포인트에서 MiniMax H3에만 적용되는 모델, 제한, 요금입니다.
MiniMax H3은 공유 비디오 생성 엔드포인트에서 동작합니다. 엔드포인트 자체, 호출 흐름, 입력 콘텐츠, 폴링, 작업 목록, 에러 코드는 AI 비디오 개요를 참고하세요. 이 페이지는 MiniMax H3에만 해당하는 내용만 다룹니다.
모델
| 모델 | 적합한 용도 | 레이트 리밋 |
|---|---|---|
MiniMax-H3 | 소리가 함께 나오는 영상, 끝 프레임 단독·참조 오디오 | 5 RPM |
POST /v1/video-generation/generate의 model 필드에 모델 이름을 넘기세요. 리터럴은 대소문자를 구분합니다(MiniMax-H3).
제한
| 제한 항목 | MiniMax H3 |
|---|---|
| 해상도 | 768p, 2k |
| 길이 | 4-15초, 정수 초만 |
| 화면 비율 | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 |
| 프롬프트 길이 | 최대 2500자, 필수 |
| 참조 이미지 | 요청당 최대 5장 |
| 참조 비디오 | 요청당 최대 3개 |
| 참조 오디오 | 요청당 최대 3개 |
inputVideoDuration | 2-15초, 참조 비디오와 함께 필수 |
768p은 짧은 변을 768픽셀로 맞춥니다(16:9이면 1344×768). 2k는 긴 변을 2560픽셀로 맞춥니다. 두 값 모두 MiniMax H3 전용이라 공유 엔드포인트의 다른 모델은 받지 않고, 반대로 MiniMax H3은 480p, 720p, 1080p을 받지 않습니다.
MiniMax H3은 first_frame, last_frame, 그리고 둘 다를 받습니다. 이 엔드포인트에서 last_frame만 단독으로 넘길 수 있는 유일한 모델이라, "이 장면으로 끝내고 싶다"는 요청에 억지 첫 프레임을 만들 필요가 없습니다. 프레임 역할과 참조 역할(reference_image, reference_video, reference_audio)은 한 요청에 같이 쓸 수 없습니다.
이미지에서 비디오를 만들 때는 입력 이미지에서 화면 비율을 가져오므로 ratio는 받되 무시됩니다. 구도는 파라미터가 아니라 넘기는 이미지를 잘라서 정하세요.
MiniMax H3은 768p과 2k만 받습니다. 480p, 720p, 1080p은 400을
반환하고, 768p과 2k를 받는 모델도 이것뿐입니다. 길이는 4-15초입니다.
4:5와 5:4는 거부되고, 이미지에서 비디오를 만들 때는 ratio 자체가
무시됩니다. seed와 generateAudio는 호환을 위해 받지만 효과는 없습니다.
결과는 seed로 재현되지 않고, 출력에는 항상 소리가 들어갑니다.
reference_image는 요청당 5장까지로, 공유 엔드포인트의 다른 모델이 허용하는
9장과 다릅니다.
요금
크레딧은 해상도와 길이에 따라 늘어납니다. 합계는 정수 크레딧으로 올림합니다.
| 해상도 | 크레딧 / 초 | 4초 | 10초 | 15초 |
|---|---|---|---|---|
768p | 9.3075 | 38 | 94 | 140 |
2k | 15.1247 | 61 | 152 | 227 |
생성 전에 정확한 비용을 알고 싶다면 MiniMax H3의 model, resolution, duration으로 POST /v1/video-generation/estimate-credits를 호출하세요. 크레딧은 작업 생성 시점에 차감되고 실패하면 자동으로 환불됩니다.
예시
curl -X POST "https://api.marswave.ai/openapi/v1/video-generation/generate" \
-H "Authorization: Bearer $LISTENHUB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3",
"content": [
{ "type": "text", "text": "The camera pushes in slowly as the city lights come up" },
{ "type": "image_url", "role": "first_frame", "image_url": { "url": "https://example.com/open.jpg" } },
{ "type": "image_url", "role": "last_frame", "image_url": { "url": "https://example.com/close.jpg" } }
],
"resolution": "768p",
"ratio": "16:9",
"duration": 8
}'전체 파라미터 목록과 텍스트에서 비디오 / 이미지에서 비디오 요청 구조는 AI 비디오 개요를 참고하세요.