텍스트 → 영상
피사체, 동작, 카메라, 조명, 사운드를 설명하면 H3가 이 내용을 완성된 영상 장면으로 만들어 줍니다.
인증된 고객은 minimax3.com API 키를 만들어 서버, 스크립트, 애플리케이션에서도 같은 사이트 크레딧을 쓸 수 있습니다. API는 비동기 방식입니다. 먼저 작업을 생성한 뒤, 영상이 준비될 때까지 상태를 폴링합니다.
계정의 ‘API 키’ 메뉴를 열고, 시크릿 키가 표시되면 바로 복사합니다.
고유한 Idempotency-Key 헤더를 넣어 POST 요청을 보냅니다.
상태가 succeeded로 바뀔 때까지 약 5초 간격으로 작업 URL을 요청합니다.
/api/v1/videos영상 작업 생성
/api/v1/videos/{task_id}작업 조회 또는 목록 조회
/api/v1/videos작업 조회 또는 목록 조회
/api/v1/videos/{task_id}/content동일한 Bearer API 키로 완성된 영상 다운로드
영상을 생성할 때는 항상 고유한 Idempotency-Key를 보내야 합니다. 같은 키로 같은 요청을 반복하면 크레딧이 두 번 차감되지 않고 원래 작업이 반환됩니다. 반환되는 video_url 주소는 비공개이므로 다운로드할 때도 같은 Bearer API 키를 포함해야 합니다.
curl -X POST https://minimax3.com/api/v1/videos \
-H "Authorization: Bearer mmx_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: product-demo-001" \
-d '{
"model": "minimax-h3",
"mode": "text-to-video",
"prompt": "A cinematic product reveal with a slow camera move",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "2K"
}'const response = await fetch('https://minimax3.com/api/v1/videos', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.MINIMAX3_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
model: 'minimax-h3',
mode: 'text-to-video',
prompt: 'A cinematic product reveal with a slow camera move',
duration: 5,
aspect_ratio: '16:9',
resolution: '2K',
}),
});
const task = await response.json();
console.log(task.id, task.status);import os
import uuid
import requests
response = requests.post(
"https://minimax3.com/api/v1/videos",
headers={
"Authorization": f"Bearer {os.environ['MINIMAX3_API_KEY']}",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"model": "minimax-h3",
"mode": "text-to-video",
"prompt": "A cinematic product reveal with a slow camera move",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "2K",
},
)
task = response.json()
print(task["id"], task["status"])curl https://minimax3.com/api/v1/videos/TASK_ID \
-H "Authorization: Bearer mmx_live_YOUR_API_KEY"curl -L https://minimax3.com/api/v1/videos/TASK_ID/content \
-H "Authorization: Bearer mmx_live_YOUR_API_KEY" \
--output minimax-h3.mp4| 필드 | 필수 | 설명 |
|---|---|---|
| model | 예 | minimax-h3를 사용합니다. |
| mode | 예 | text-to-video, image-to-video 또는 reference-to-video. |
| prompt | 예 | 영상 설명, 최대 7,000자. |
| duration | 아니요 | 4~15초의 정수. 기본값: 5. |
| aspect_ratio | 아니요 | 21:9, 16:9, 4:3, 1:1, 3:4 또는 9:16. |
| resolution | 아니요 | 2K. |
| image_url | 모드에 따라 다름 | image-to-video용 HTTPS 시작 이미지 URL. |
| last_frame_url | 아니요 | 선택 사항인 HTTPS 마지막 프레임 URL. |
| reference_image_urls | 모드에 따라 다름 | 최대 9개의 HTTPS 참조 이미지 URL. |
아이디어에 맞는 입력 방식을 고르면 됩니다. MiniMax H3는 프롬프트로 장면을 만들고, 기존 이미지에 움직임을 입히고, 참조를 활용해 비주얼을 일관되게 유지할 수 있습니다.
피사체, 동작, 카메라, 조명, 사운드를 설명하면 H3가 이 내용을 완성된 영상 장면으로 만들어 줍니다.
시작 이미지를 올리고 장면이 어떻게 움직여야 하는지 H3에 알려 주면 됩니다. 더 세밀하게 제어하려면 마지막 프레임도 추가할 수 있습니다.
캐릭터, 제품, 구도, 비주얼 스타일을 한눈에 알아볼 수 있게 유지해야 할 때는 참조 이미지를 추가합니다.
사용자는 창작에 필요한 선택에만 집중하면 됩니다. 생성 작업, 진행 상황 추적, 결과 저장, 조건에 맞는 크레딧 환불은 저희가 백그라운드에서 처리합니다.
텍스트 또는 이미지 모드를 고르고 프롬프트를 작성합니다.
4~15초 중에서 길이를 고르고 2K 영상 생성을 시작합니다.
‘내 작업물’에서 진행 상황과 완성된 영상을 확인합니다.
영상을 다운로드하거나, 프롬프트를 다듬거나, 새로운 아이디어를 더 찾아봅니다.
쓸모 있는 프롬프트에는 피사체, 동작, 환경, 카메라, 조명, 템포, 사운드가 함께 들어갑니다. 가장 중요한 조건은 앞쪽에 두고, 서로 충돌하는 지시는 피합니다.
네. MiniMax H3로 2K 텍스트 → 영상 및 이미지 → 영상 작업을 생성할 수 있으며, 길이는 4~15초입니다.
웹사이트에서 영상을 생성할 때는 API 키가 필요하지 않습니다. 개발자는 계정 설정에서 minimax3.com API 키를 생성한 뒤 동일한 사이트 크레딧을 프로그래밍 방식으로 사용할 수 있습니다.
이 사이트에서 H3 생성에 드는 크레딧은 주로 영상 길이에 따라 정해집니다. 생성하기 전에 요금제 페이지에서 현재 크레딧 플랜을 확인하고 사용량에 맞는 옵션을 고르면 됩니다.
아닙니다. H3 Max는 H3의 오픈 가중치를 바탕으로 사후 학습한 별도 모델로, 연속 생성 방식의 Director 모드가 추가되어 있습니다. 5초짜리 768P 클립을 3초 안에 렌더링하지만 2K 모드는 없습니다. 반면 이 사이트에서 쓰는 MiniMax H3 API는 2K까지 지원합니다.
아직은 안 됩니다. 이 사이트의 생성 기능은 최대 2K의 MiniMax H3로 실행됩니다. 그동안 H3 Max의 엔드포인트, 초당 요금, Director 세션의 최소 60초 과금 기준은 H3 Max 레퍼런스 페이지에 정리해 두고 있습니다.
네. 결제 이력이 있는 인증된 고객은 API 키를 만들어 POST /api/v1/videos로 작업을 생성하고, GET /api/v1/videos/{task_id}로 결과를 조회할 수 있습니다.
저희는 실패한 생성 작업을 기록하고, 사이트 크레딧 규정에 따라 해당 작업에 사용된 크레딧을 자동으로 반환하려고 시도합니다.