영상 생성을 위한 MiniMax H3 API

입력에 맞는 H3 모델 고르기
hailuo_h3: 텍스트, 첫 프레임, 첫·마지막 프레임
image_url을 쓰는 이미지로 영상 만들기, 여기에 선택적으로 image_end_url을 더한 첫·마지막 프레임 제어에는 hailuo_h3를 사용하세요. prompt는 필수이며 최대 7,000자입니다. 플레이그라운드와 전체 파라미터 문서를 확인하세요.
hailuo_h3_refs: 레퍼런스 기반 생성
hailuo_h3_refs를 사용하세요. 이 경로는 MiniMax 공식 채널을 거치며 768P와 2K 출력을 지원합니다. 레퍼런스 기반 영상 생성 엔드포인트를 참고하세요.
독립적인 통합 API 액세스

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