MiniMax H3 API

MiniMax H3 소개

텍스트, 이미지, 비디오, 오디오 참조를 한 번의 요청으로 따라가며 최대 2K에서 4초에서 15초짜리 클립을 네이티브 스테레오 오디오로 생성합니다.

MiniMax H3 사양

모델 ID

minimax-h3

개발사

MiniMax

카테고리

영상 생성

출시

2026년 7월 31일

입력

텍스트이미지비디오오디오

출력

비디오

리전

Singapore

엔드포인트

POST/v1/videos/generations

대체 모델 ID

minimax/minimax-h3hailuo-3minimax/hailuo-3

MiniMax H3 API 요금

EmpirioLabs 카탈로그의 실시간 종량제 요금입니다. 사용한 만큼만 결제하며 월 최소 요금이 없습니다.

MiniMax H3 API 호출 방법

MiniMax H3은(는) POST /v1/videos/generations로 실행됩니다. 요청은 즉시 job_id를 반환하며, 작업이 완료될 때까지 GET /v1/jobs/{job_id}을 폴링한 뒤 결과에서 출력 URL을 읽으세요. EmpirioLabs 대시보드에서 API 키를 발급받으세요.

curl https://api.empiriolabs.ai/v1/videos/generations \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "prompt": "Describe what you want MiniMax H3 to generate."
  }'

curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/videos/generations",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "minimax-h3",
        "prompt": "Describe what you want MiniMax H3 to generate.",
    },
)
job = response.json()

# Generation runs as an async job. Poll until it completes.
import time
while True:
    status = requests.get(
        f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
        headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    ).json()
    if status.get("status") in ("completed", "failed"):
        print(status)
        break
    time.sleep(5)

MiniMax H3 API 파라미터

EmpirioLabs에서 MiniMax H3 API가 지원하는 요청 파라미터입니다. 필드를 생략하면 기본값이 적용됩니다.

알아두면 좋은 점

MiniMax H3는 768p 또는 2K 해상도로 24fps로 4초에서 15초 분량의 클립을 생성하며, 각 클립에는 네이티브 스테레오 오디오 트랙이 포함되어 있습니다. 모드 - 텍스트에서 비디오로: 프롬프트만. - 이미지에서 비디오로: 한 이미지가 오프닝 프레임이 됩니다. - 첫 번째와 마지막 프레임: 오프닝과 클로징 이미지를 제공한다. - 비디오 참조: 최대 9장의 이미지, 3개의 동영상, 3개의 오디오 클립, 총 12개의 참조 파일. - 재생: 이전에 생성한 768p 클립을 2K로 다시 렌더링합니다. 원본 프롬프트와 원본 클립을 base_video로 보내세요. 프롬프트 확장 enhance_prompt를 true로 설정하면 모델이 먼저 브리프를 전체 프롬프트로 다시 작성하고, shot-by-shot구조, 카메라 움직임, 조명, 사운드스케이프를 추가한 후 그걸 렌더링합니다. 첨부하는 모든 참조 매체는 확장에 정보를 제공합니다. 초당 비디오 비용 외에 토큰당 요금이 추가되며, 재생 경로는 원래 요청을 재현하기 때문에 건너뛸 수 있습니다. 참조 미디어 - 한 변당 256에서 5760 픽셀, 화면 비율 0.4에서 2.5 사이, 각 이미지당 최대 30 MB. - 2초에서 15초 분량의 동영상, H.264 또는 H.265, 각 영상 최대 50MB. - 오디오 재생 시간은 2초에서 15초, WAV 또는 MP3, 각각 최대 15MB까지 참고 오디오는 첨부된 이미지 또는 비디오 참조가 필요합니다. - 참조 영상과 오디오는 reference-to-video에만 적용됩니다. - 프롬프트는 최대 7000자까지 가능하며, 대사, 효과음, 화면 텍스트, 카메라 워크를 설명할 수 있습니다. 청구 - 생성된 클립의 초당 청구 단위로, 요청하신 해상도에 적용됩니다. - 참조 영상은 생성된 클립 외에 자체 길이에 따라 요금이 청구되므로, 6초 클립을 만드는 데 사용되는 5초 참조는 11초로 청구됩니다. - 재생은 소스 클립 길이와 재생된 출력에 따라 초당 낮은 속도로 청구됩니다. 원래 요청에서 가져온 참조 이미지는 다시 요금이 부과되지 않습니다. - 처음 5장의 참고 이미지가 포함되어 있습니다. 각 추가 참조 이미지는 별도로 요금이 부과됩니다. - 프롬프트 확장은 활성화 시 토큰 단위로 요금이 청구됩니다.

MiniMax H3 API: 자주 묻는 질문

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

EmpirioLabs에서 MiniMax H3은(는) 종량제로 청구됩니다: 768p $0.18 초당; 2K $0.26 초당; 2K 재생 $0.10 초당; 참조 이미지 입력 $0.08 처음 5개 이후의 입력 이미지별; 프롬프트 확장 입력 $1.80 1M 프롬프트 토큰당; 프롬프트 확장 출력 $7.20 생성된 토큰 1M 단위. 이 페이지의 실시간 요금표는 항상 API 청구 금액과 일치합니다.

MiniMax H3은(는) 어떤 엔드포인트를 사용하나요?

MiniMax H3은(는) api.empiriolabs.ai의 POST /v1/videos/generations를 통해 제공되며 표준 Bearer 토큰 인증을 사용합니다.

통합하기 전에 브라우저에서 MiniMax H3을(를) 사용해 볼 수 있나요?

네. EmpirioLabs 플레이그라운드에서 API와 동일한 파라미터로 MiniMax H3을(를) 브라우저에서 실행하므로 코드를 작성하기 전에 프롬프트를 테스트할 수 있습니다.

MiniMax H3 API 키는 어떻게 발급받나요?

EmpirioLabs 계정을 만든 다음 대시보드의 API Keys에서 키를 생성하세요. 요금은 종량제 크레딧이라 실행한 요청에 대해서만 결제합니다.