Skip to main content

​
개요

MiniMax H3 (Hailuo 3.0)은 MiniMax가 2026-07-31 (UTC+8)에 출시한 옴니모달 동영상 모델입니다. 단일 모델로 텍스트, 이미지, 동영상, 오디오를 입력받아 스테레오 오디오 트랙이 포함된 동영상을 출력합니다. APIYI는 오픈 가중치 자체 호스팅 배포를 통해 MiniMax-H3을 제공하며, 768P 해상도, 클립당 4–15초 길이로 초당 과금됩니다.
주요 특징: 하나의 엔드포인트로 텍스트 투 비디오, 첫 프레임 / 마지막 프레임 / 첫 프레임 및 마지막 프레임 동영상, 그리고 최대 9개의 이미지, 3개의 동영상, 3개의 오디오 클립을 활용한 혼합 참조 생성을 지원합니다. 모든 클립에 음악과 음향 효과가 함께 제공됩니다. 초당 $0.03(공식 MiniMax API 요금은 $0.08)로 10초 클립의 비용은 $0.30이며, 실패한 작업은 자동으로 환불됩니다.

동영상 생성 API 레퍼런스

작업을 생성하고 task_id로 조회할 수 있으며, Python / cURL / Node.js 예제 및 실시간 Playground를 제공합니다.

충전 보너스

충전 보너스를 통해 실질 가격을 더욱 낮출 수 있습니다.

​
AI 에이전트를 통한 연동

Codex / Claude Code / Cursor를 사용하여 개발하는 경우 아래 prompt를 복사하여 입력하십시오. 에이전트는 먼저 이 페이지의 일반 텍스트 버전을 가져온 다음(모든 문서 URL 끝에 .md 추가), 사용 중인 기술 스택에 맞는 코드를 작성합니다. 자주 발생하는 실수는 이미 명시되어 있습니다. 경로에는 /hailuo가 필요하고, 결과는 task 내부에 위치하며, duration는 4부터 15까지의 정수여야 합니다.

코딩 에이전트에게 MiniMax-H3 동영상 생성을 연동하거나 디버깅하도록 요청합니다. 이를 Codex, Claude Code, Cursor 및 유사한 도구에 복사하여 붙여넣으십시오.

​
왜 APIYI의 MiniMax-H3를 선택해야 할까요?

모든 기능 완벽 지원

텍스트, 첫 프레임/마지막 프레임, 이미지·동영상·오디오 혼합 참조 생성을 모두 지원하며, 공식 모델과 동일한 참조 제한(이미지 9장 + 동영상 3개 + 오디오 클립 3개)이 적용됩니다

초 단위 과금, 실패 시 전액 환불

초당 $0.03이며, 성공한 동영상에 대해서만 과금됩니다. 실패한 작업은 전액 환불되며 제출 오류는 무료입니다

충전 보너스 중복 적용

충전 보너스와 함께 이용하시면 실질 비용을 더욱 낮출 수 있습니다

제약 없는 글로벌 접속

해외 계정 없이 하나의 API Key로 api.apiyi.com에 바로 연결할 수 있습니다

풍부한 동영상 모델 라인업

동일한 키로 Seedance 2.0 / 2.5, Wan2.7, VEO 3.1 등 다양한 모델도 이용하실 수 있습니다

전문 기술 지원

연동 관련 문의는 기술 지원팀에 연락해 주시기 바라며, 엔터프라이즈 고객에게는 전담 온보딩 지원을 제공합니다

​
주요 기능

네이티브 스테레오 오디오

모든 클립에는 별도의 더빙 작업 없이 prompt 및 참조 오디오를 기반으로 한 음악과 효과음이 포함됩니다

7가지 화면비

21:9부터 9:16까지의 6가지 고정 화면비 및 참조 이미지를 따르는 adaptive를 지원합니다

4초부터 15초까지의 모든 정수 단위 길이

요청된 실제 초 단위로 과금되므로 짧은 클립일수록 비용이 적게 듭니다

긴 prompt

prompt당 최대 7000자까지 지원하여 샷별(shot-by-shot) 상세 묘사에도 충분합니다

첫 프레임/마지막 프레임 제어

첫 프레임만 지정하거나, 마지막 프레임만 지정하거나, 둘 다 지정하여 클립의 시작과 끝을 설정할 수 있습니다

다중 참조 이미지

최대 9장의 참조 이미지를 지원하며, prompt 내에서 <Picture 1> 등으로 인물과 사물을 태그할 수 있습니다

동영상 모션 전이

카메라 움직임과 모션 리듬을 복제할 수 있는 최대 3개의 참조 동영상을 지원합니다

오디오 기반 동영상

최대 3개의 참조 오디오 클립을 지원하며, 화면이 음악이나 음성을 따릅니다

​
요금 안내

본 채널은 MiniMax의 오픈 H3 가중치를 자체 배포하여 구동합니다. 이는 공식 MiniMax API의 릴레이가 아니므로, 자체적인 요금이 적용됩니다:
본 채널은 오픈 가중치를 자체 배포하여 운영되며, 공식 MiniMax API와는 독립적으로 가격이 책정되므로 가격이 변동될 수 있습니다. 위 표는 참고용일 뿐이며, 상단 탐색 메뉴의 모델 요금 안내 탭이 기준이 됩니다: 모델 요금 안내. 공식 가격 출처: platform.minimax.io/docs/guides/pricing-paygo(2026-09-29 기준).
과금 세부사항:
  • 요청된 duration(초 단위)를 기준으로 과금되며, 작업 접수 시 사전 청구됩니다
  • 참조 미디어 추가 요금 없음: 참조 이미지(최대 9장), 동영상 및 오디오는 가격에 영향을 미치지 않으며, 오직 재생 시간에 대해서만 과금됩니다
  • 실패한 작업(미디어 다운로드 실패, 지원되지 않는 형식, 실행 실패 등)은 자동으로 전액 환불됩니다
  • 제출 시 4xx / 5xx를 반환하는 요청은 과금되지 않으며, 조회 및 다운로드는 무료입니다
  • 더 저렴한 실질 비용을 원하시면 충전 보너스를 확인하시기 바랍니다

​
그룹 설정

MiniMax-H3는 default 그룹에서 작동하며, svip 그룹에서도 작동하므로 전용 그룹이 필요하지 않습니다. Token의 과금 모델을 종량제 우선으로 설정하는 것을 권장합니다. 호출 시 “no available channels for the current group” 오류가 반환된다면 Token의 그룹에 해당 모델이 포함되어 있지 않거나 model 값의 철자가 잘못되었을 수 있습니다(대소문자를 구분합니다).

​
기술 사양

공식 MiniMax H3 모델은 2K를 지원하지만, 이 채널은 768P만 제공하므로 2K는 거부됩니다.

​
API 엔드포인트

기본 호스트 https://api.apiyi.com, 백업 호스트 https://vip.apiyi.com이며 경로는 동일합니다. 경로는 /hailuo(으)로 시작하며 /v1이 아니라는 점에 유의하십시오.

​
생성 모드

생성 모드는 content[]의 미디어로부터 추론됩니다:

​
prompt 내 미디어 참조

각 미디어 유형은 content[]의 순서에 따라 번호가 지정됩니다. 첫 번째 및 두 번째 레퍼런스 이미지는 <Picture 1> 및 <Picture 2>이고, 첫 번째 레퍼런스 동영상은 <Video 1>이며, 첫 번째 레퍼런스 오디오 클립은 <Audio 1>입니다. 예를 들면 다음과 같습니다:
  • 첫 프레임/마지막 프레임은 어떤 레퍼런스 미디어와도 결합할 수 없습니다
  • 단일 이미지의 경우 role을 생략할 수 있습니다(첫 프레임으로 처리됨). 이미지가 2장 이상인 경우 각각에 role을 설정해야 합니다
  • 레퍼런스 동영상의 합산 길이는 15초를 초과할 수 없으며, 그렇지 않으면 작업이 실패합니다(환불 처리됨). 15초를 초과하는 단일 클립은 앞부분 15초로 잘립니다

​
모범 사례

1

먼저 4–5초 길이로 테스트하십시오

과금은 초 단위로 이루어지므로, 10–15초를 렌더링하기 전에 짧은 영상으로 구도와 스타일을 확인하십시오
2

텍스트 기반 동영상 생성 시 고정 비율을 사용하십시오

가로 방향에는 16:9, 세로 방향에는 9:16, 와이드스크린에는 21:9를 사용하십시오. 첫 번째 프레임이 있는 경우 adaptive은 이미지의 비율을 유지합니다
3

안정적인 퍼블릭 스토리지에 미디어를 호스팅하십시오

핫링크 방지나 만료된 서명으로 인해 미디어 다운로드가 중단되지 않도록 자체 오브젝트 스토리지 또는 CDN의 직접 링크를 사용하십시오
4

카메라 움직임과 사운드를 묘사하십시오

피사체, 동작, 카메라 움직임, 조명, 원하는 음악 및 음향 효과를 포함하십시오. 모델이 이들을 함께 생성합니다
5

10초마다 폴링하십시오

생성에는 일반적으로 2–4분이 소요되므로 전체 클라이언트 타임아웃을 15분으로 설정하십시오
6

멱등성을 직접 처리하십시오

비즈니스 ID와 task_id 간의 매핑을 유지하십시오. 제출이 타임아웃되면 다시 제출하기 전에 기존 작업을 확인하십시오
7

동영상을 즉시 저장하십시오

GET으로 task.content.url을 다운로드하여 자체 스토리지에서 제공하십시오

​
오류 코드 및 재시도

클라이언트 팁: 제출 타임아웃을 60초로 설정하십시오(피크 시간대에는 제출에만 10초 이상 소요될 수 있습니다). HTTP 500 오류 및 네트워크 오류에 대해서만 백오프를 적용하여 재시도하십시오. 실행 단계의 모든 실패는 자동으로 환불되며, 다시 제출하면 새로 과금됩니다.

​
자주 묻는 질문

경로에 /hailuo 접두사가 누락되었습니다. 올바른 경로는 /hailuo/v2/video_generation 및 /hailuo/v2/query/video_generation/{task_id}입니다.
이 채널은 768P만 지원합니다. 공식 MiniMax 모델은 2K를 지원하지만, 이 채널에서는 제공하지 않습니다.
아닙니다. duration는 4부터 15까지의 정수입니다.
모든 클립에는 스테레오 오디오 트랙이 포함되어 있으며, 이를 비활성화하는 매개변수는 없습니다. 필요하지 않은 경우 후처리에서 트랙을 제거하십시오.
현재는 지원되지 않습니다. 동일한 Idempotency-Key(으)로 다시 제출하더라도 별도로 과금되는 새 작업이 생성됩니다. 제출된 작업은 자체 애플리케이션에서 추적하십시오.
아닙니다. 작업이 failed에 도달하면 전액 자동으로 환불되며, 제출 시 거부된 요청 역시 과금되지 않습니다.
아닙니다. 모든 미디어는 공개 HTTPS URL이어야 합니다. 먼저 자체 객체 스토리지에 업로드한 후 링크를 전달하십시오.
입력 이미지의 종횡비를 따릅니다. 예를 들어 정사각형 이미지는 768×768, 16:9 이미지는 1344×768입니다. 텍스트 전용 및 오디오 전용 요청에는 adaptive를 사용할 수 없습니다.
15초를 초과하는 단일 클립은 처음 15초 분량으로 자동 잘라내기되지만, 여러 참조 동영상의 총합이 15초를 초과하면 작업이 실패합니다(환불 처리됩니다).
측정된 중앙값은 약 3분이며, 일반적으로 24분 정도 소요됩니다. 1015초 분량의 클립은 약간 더 오래 걸립니다.
빠르게 만료되는 현상은 확인되지 않았으나 장기적인 가용성은 보장되지 않으므로, 동영상을 즉시 다운로드하여 저장하십시오. URL 유효성 확인 시 GET을 사용하십시오. HEAD 요청은 403을 반환합니다.
먼저 요청 본문이 규칙(정확히 하나의 텍스트 항목, 추가 필드 없음, https 미디어 링크)을 준수하는지 확인하십시오. 규칙을 준수하고 있다면 대개 일시적인 과부하이므로, 몇 초간 기다린 후 다시 시도하십시오. 제출에 실패한 요청은 과금되지 않습니다.

​
관련 문서