영상 생성을 위한 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 출력을 지원합니다. 레퍼런스 기반 영상 생성 엔드포인트를 참고하세요.
hailuo_h3_refs: 레퍼런스 기반 생성

독립적인 통합 API 액세스

GoEnhance Open API는 여러 영상·이미지 모델에 대한 통합 액세스를 제공하는 독립 서드파티 플랫폼입니다. MiniMax나 Hailuo가 아니며, MiniMax와 제휴 관계가 없고 승인을 받은 바도 없습니다. MiniMax와 Hailuo는 각 권리자의 상표이며, 여기서는 모델을 가리키는 용도로만 사용됩니다.
독립적인 통합 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의 해상도와 화면 비율

480p, 720p, 2K 중에서 고를 수 있습니다. 텍스트로 영상을 만들 때만 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입니다.

네이티브 스테레오 오디오

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건에서 시작합니다. 요금 등급과 크레딧을 확인하세요.

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의 동시 실행 한도에 도달하면 새 요청은 큐에 넣으세요.
API 키 만들기
비동기 작업, 네이티브 오디오, 명시적인 프레임·레퍼런스 입력을 중심으로 반복 가능한 미디어 파이프라인을 만드세요.

개발자들이 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 영상 모델 페이지를 방문하세요.

MiniMax H3 API 연동 시작하기