영상 생성을 위한 MiniMax H3 API
독립 플랫폼인 GoEnhance Open API를 통해 MiniMax H3를 사용할 수 있습니다. 텍스트, 프레임 이미지, 레퍼런스 소재를 비동기 REST 워크플로에 보내면 img_uuid를 받고, 이후 결과를 폴링하거나 콜백을 등록하면 됩니다. H3는 대사, 효과음, 공간음을 네이티브 스테레오 오디오로 영상과 같은 한 번의 생성 과정에서 만들어 냅니다.
API 키 만들기
입력에 맞는 H3 모델 고르기
hailuo_h3: 텍스트, 첫 프레임, 첫·마지막 프레임
텍스트로 영상 만들기, image_url을 쓰는 이미지로 영상 만들기, 여기에 선택적으로 image_end_url을 더한 첫·마지막 프레임 제어에는 hailuo_h3를 사용하세요. prompt는 필수이며 최대 7,000자입니다. 플레이그라운드와 전체 파라미터 문서를 확인하세요.
hailuo_h3_refs: 레퍼런스 기반 생성
한 요청에 레퍼런스 이미지 최대 9장, 레퍼런스 영상 3개, 레퍼런스 오디오 3개가 필요하다면 hailuo_h3_refs를 사용하세요. 이 경로는 MiniMax 공식 채널을 거치며 768P와 2K 출력을 지원합니다. 레퍼런스 기반 영상 생성 엔드포인트를 참고하세요.
독립적인 통합 API 액세스
GoEnhance Open API는 여러 영상·이미지 모델에 대한 통합 액세스를 제공하는 독립 서드파티 플랫폼입니다. MiniMax나 Hailuo가 아니며, MiniMax와 제휴 관계가 없고 승인을 받은 바도 없습니다. MiniMax와 Hailuo는 각 권리자의 상표이며, 여기서는 모델을 가리키는 용도로만 사용됩니다.
제출 전에 이 필드들을 검증해 두면, 잘못된 요청이 포인트 차감 전에 걸러집니다.
MiniMax H3 API 파라미터와 제한
공통 엔드포인트와 비동기 응답
두 모델 모두 <code>POST https://api.goenhance.ai/api/v1/videos/generations</code>로 제출합니다. 응답으로 <code>img_uuid</code>가 먼저 돌아오고, 생성은 비동기로 계속됩니다.
hailuo_h3의 길이와 프롬프트
<code>duration</code>은 5~15초 사이의 정수여야 하며 기본값은 5입니다. 정수가 아니거나 범위를 벗어난 값은 포인트가 차감되기 전에 거부됩니다. <code>prompt</code>는 필수이며 최대 7,000자까지 받습니다.
hailuo_h3의 해상도와 화면 비율
480p, 720p, 2K 중에서 고를 수 있습니다. 텍스트로 영상을 만들 때만 <code>ratio</code>에 21:9, 16:9, 4:3, 1:1, 3:4, 9:16을 지정할 수 있습니다. <code>image_url</code>로 첫 프레임을 넘기면 출력은 그 이미지를 따르고 ratio 파라미터는 쓰이지 않습니다.
hailuo_h3의 프레임 입력
첫 프레임은 <code>image_url</code>로, 마지막 프레임은 선택적으로 <code>image_end_url</code>로 넘깁니다. 이 모델 ID 하나로 텍스트로 영상 만들기, 이미지로 영상 만들기, 첫·마지막 프레임 생성을 모두 처리합니다.
hailuo_h3_refs의 레퍼런스 입력
한 요청에서 <code>ref_imgs</code>에 이미지 9장, <code>ref_videos</code>에 영상 3개, <code>ref_audios</code>에 오디오 3개까지 받습니다. 길이는 5~15초 사이의 정수이며 기본값은 5, 해상도는 768P 또는 2K입니다.
네이티브 스테레오 오디오
H3는 대사, 효과음, 공간음을 나중에 더빙하는 대신 영상과 같은 한 번의 생성 과정에서 네이티브 스테레오 오디오로 만들어 냅니다.
호출당 비용은 선택한 등급의 초당 단가에 요청한 출력 길이를 곱한 값입니다. 영상 모델은 출력 초 단위로 과금됩니다.
MiniMax H3 초당 가격
hailuo_h3 — 480p: 초당 $0.030
저비용으로 프롬프트를 반복 실험하기 위한 GoEnhance 자체 파이프라인 등급입니다. MiniMax가 공식 지원하는 출력 등급이 아닙니다.
hailuo_h3 — 720p: 초당 $0.060
최종 컷을 고르기 전에 더 저렴하게 시험해 보기 위한 GoEnhance 자체 파이프라인 등급입니다. MiniMax가 공식 지원하는 출력 등급이 아닙니다.
hailuo_h3 — 2K: 초당 $0.090
MiniMax 공식 출력 해상도가 필요한 선택된 컷에는 2K 등급을 사용하세요.
hailuo_h3_refs — 768P: 초당 $0.099
레퍼런스 기반 생성은 MiniMax 공식 채널로만 처리되므로 등급과 가격이 다릅니다.
hailuo_h3_refs — 2K: 초당 $0.143
레퍼런스 기반 요청을 위한 2K 공식 채널 등급입니다.
토큰, 환불, 동시 실행
사용량은 토큰 단위로 과금됩니다. $10에 500 토큰, 토큰당 $0.02입니다. 포인트는 제출 시점에 한 번 차감되고 생성이 실패하면 전액 환불됩니다. 동시 실행 수는 계정의 Build Tier에 따라 정해지며 미완료 작업 3건에서 시작합니다. <a href="/billing">요금 등급과 크레딧</a>을 확인하세요.
MiniMax H3 영상 API 연동하기
1
1. API 키를 만들고 안전하게 보관하기
/keys에서 키를 만들고
Authorization: Bearer <API key> 형태로 보내세요. 브라우저 코드나 로그에 노출해서는 안 됩니다. 2
2. 모델을 고르고 요청을 검증하기
텍스트나 프레임 제어에는
hailuo_h3, 레퍼런스 소재에는 hailuo_h3_refs를 고르세요. 제출 전에 길이, 해상도, ratio 적용 여부, 프롬프트 길이, 각 입력 개수를 검증하세요. 3
3. 제출하고 img_uuid 저장하기
요청을
https://api.goenhance.ai/api/v1/videos/generations로 POST하세요. 작업이 비동기이므로 돌아온 img_uuid를 자체 작업 기록에 저장해 두어야 합니다. 4
4. 폴링하거나 콜백 받기
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=...를 폴링하거나 콜백 URL을 등록하세요. 작업이 실행되기 시작하면 status=0 콜백이 오고, 종료 콜백이 결과를 전달합니다. 5
5. 검증 오류, 실패, 동시 실행 처리하기
잘못된 길이나 호환되지 않는 입력 조합을 그대로 재시도하지 마세요. 생성에 실패하면 전액 환불됩니다. 미완료 작업이 Build Tier의 동시 실행 한도에 도달하면 새 요청은 큐에 넣으세요.
비동기 작업, 네이티브 오디오, 명시적인 프레임·레퍼런스 입력을 중심으로 반복 가능한 미디어 파이프라인을 만드세요.
개발자들이 H3로 만드는 것
프로그래매틱 광고 소재
구조화된 프롬프트로 짧은 캠페인 시안을 대량 생성한 뒤, 승인된 결과물만 남깁니다.
제품 영상 파이프라인
제품 이미지를 첫 프레임으로 삼아, 그 이미지의 화면 비율을 따르는 짧은 클립을 생성합니다.
현지화 영상 광고
영상, 대사, 효과음, 공간음을 한 번에 생성한 뒤 각 결과를 현지화·검수 워크플로로 넘깁니다.
UGC 제작 시스템
투고, 작업 추적, 콜백, 모더레이션, 에셋 저장을 이어 붙여 숏폼 콘텐츠 제작을 자동화합니다.
제한, 모델 선택, 과금, 오디오, 그리고 플랫폼 관계에 대해.