MiniMax H3 · 2K AI 영상 생성기

MiniMax H3 API2K 영상 제작을 간단하게

텍스트나 이미지로 4~15초 길이의 2K 영상을 만들 수 있습니다. 온라인 생성기를 바로 쓰거나, minimax3.com API 키를 만들어 MiniMax H3를 자체 서버나 애플리케이션에 연결하면 됩니다.

2K 출력
4~15초
네이티브 오디오
비공개 작업 기록
개발자 빠른 시작

몇 분 안에 MiniMax H3 API 호출하기

인증된 고객은 minimax3.com API 키를 만들어 서버, 스크립트, 애플리케이션에서도 같은 사이트 크레딧을 쓸 수 있습니다. API는 비동기 방식입니다. 먼저 작업을 생성한 뒤, 영상이 준비될 때까지 상태를 폴링합니다.

API 키 만들기

1. 키 생성

계정의 ‘API 키’ 메뉴를 열고, 시크릿 키가 표시되면 바로 복사합니다.

2. 작업 제출

고유한 Idempotency-Key 헤더를 넣어 POST 요청을 보냅니다.

3. 결과 폴링

상태가 succeeded로 바뀔 때까지 약 5초 간격으로 작업 URL을 요청합니다.

엔드포인트

POST/api/v1/videos

영상 작업 생성

GET/api/v1/videos/{task_id}

작업 조회 또는 목록 조회

GET/api/v1/videos

작업 조회 또는 목록 조회

GET/api/v1/videos/{task_id}/content

동일한 Bearer API 키로 완성된 영상 다운로드

기본 제한

  • 분당 생성 요청 5회
  • 계정당 진행 중인 영상 작업 2개
  • 분당 상태 요청 60회
  • 활성 API 키 최대 3개

바로 실행할 수 있는 예제

영상을 생성할 때는 항상 고유한 Idempotency-Key를 보내야 합니다. 같은 키로 같은 요청을 반복하면 크레딧이 두 번 차감되지 않고 원래 작업이 반환됩니다. 반환되는 video_url 주소는 비공개이므로 다운로드할 때도 같은 Bearer API 키를 포함해야 합니다.

cURL · 2K 영상 생성
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"
  }'
JavaScript · 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);
Python · 2K 영상 생성
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 · 작업 상태 확인
curl https://minimax3.com/api/v1/videos/TASK_ID \
  -H "Authorization: Bearer mmx_live_YOUR_API_KEY"
cURL · 완성된 영상 다운로드
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 API로 무엇을 만들 수 있나요?

아이디어에 맞는 입력 방식을 고르면 됩니다. MiniMax H3는 프롬프트로 장면을 만들고, 기존 이미지에 움직임을 입히고, 참조를 활용해 비주얼을 일관되게 유지할 수 있습니다.

텍스트 → 영상

피사체, 동작, 카메라, 조명, 사운드를 설명하면 H3가 이 내용을 완성된 영상 장면으로 만들어 줍니다.

이미지 → 영상

시작 이미지를 올리고 장면이 어떻게 움직여야 하는지 H3에 알려 주면 됩니다. 더 세밀하게 제어하려면 마지막 프레임도 추가할 수 있습니다.

참조 기반 생성

캐릭터, 제품, 구도, 비주얼 스타일을 한눈에 알아볼 수 있게 유지해야 할 때는 참조 이미지를 추가합니다.

작동 방식

이 사이트에서 MiniMax H3 API를 사용하는 방법

사용자는 창작에 필요한 선택에만 집중하면 됩니다. 생성 작업, 진행 상황 추적, 결과 저장, 조건에 맞는 크레딧 환불은 저희가 백그라운드에서 처리합니다.

1. 준비

텍스트 또는 이미지 모드를 고르고 프롬프트를 작성합니다.

2. 생성

4~15초 중에서 길이를 고르고 2K 영상 생성을 시작합니다.

3. 확인

‘내 작업물’에서 진행 상황과 완성된 영상을 확인합니다.

4. 재사용

영상을 다운로드하거나, 프롬프트를 다듬거나, 새로운 아이디어를 더 찾아봅니다.

안전한 계정 접근
실패한 작업은 환불되는 사이트 크레딧
프롬프트 레시피

샷의 느낌을 H3에 전달하기

쓸모 있는 프롬프트에는 피사체, 동작, 환경, 카메라, 조명, 템포, 사운드가 함께 들어갑니다. 가장 중요한 조건은 앞쪽에 두고, 서로 충돌하는 지시는 피합니다.

어두운 반사 테이블 위에서 회전하는 브러시드 실버 스마트워치, 느린 돌리 인, 부드러운 보라색 림 라이트, 고급 제품 영상다운 템포, 은은한 기계음 앰비언스, 16:9.

MiniMax H3 API 자주 묻는 질문

MiniMax H3를 minimax3.com에서 사용할 수 있나요?

네. MiniMax H3로 2K 텍스트 → 영상 및 이미지 → 영상 작업을 생성할 수 있으며, 길이는 4~15초입니다.

별도의 모델 API 키가 필요한가요?

웹사이트에서 영상을 생성할 때는 API 키가 필요하지 않습니다. 개발자는 계정 설정에서 minimax3.com API 키를 생성한 뒤 동일한 사이트 크레딧을 프로그래밍 방식으로 사용할 수 있습니다.

MiniMax H3 API 비용은 얼마인가요?

이 사이트에서 H3 생성에 드는 크레딧은 주로 영상 길이에 따라 정해집니다. 생성하기 전에 요금제 페이지에서 현재 크레딧 플랜을 확인하고 사용량에 맞는 옵션을 고르면 됩니다.

H3 Max API는 MiniMax H3 API와 동일한가요?

아닙니다. H3 Max는 H3의 오픈 가중치를 바탕으로 사후 학습한 별도 모델로, 연속 생성 방식의 Director 모드가 추가되어 있습니다. 5초짜리 768P 클립을 3초 안에 렌더링하지만 2K 모드는 없습니다. 반면 이 사이트에서 쓰는 MiniMax H3 API는 2K까지 지원합니다.

이 사이트에서 H3 Max로 생성할 수 있나요?

아직은 안 됩니다. 이 사이트의 생성 기능은 최대 2K의 MiniMax H3로 실행됩니다. 그동안 H3 Max의 엔드포인트, 초당 요금, Director 세션의 최소 60초 과금 기준은 H3 Max 레퍼런스 페이지에 정리해 두고 있습니다.

공개 개발자 엔드포인트를 호출할 수 있나요?

네. 결제 이력이 있는 인증된 고객은 API 키를 만들어 POST /api/v1/videos로 작업을 생성하고, GET /api/v1/videos/{task_id}로 결과를 조회할 수 있습니다.

생성이 실패하면 어떻게 되나요?

저희는 실패한 생성 작업을 기록하고, 사이트 크레딧 규정에 따라 해당 작업에 사용된 크레딧을 자동으로 반환하려고 시도합니다.

첫 H3 영상을 만들 준비가 되셨나요?

프롬프트를 쓰거나 이미지를 올리고 길이를 고르면, H3가 첫 번째 버전을 만들어 줍니다.

H3 생성기 열기