MiniMax H3-Image는 MiniMax가 2026년 11월 10일에 공개한 오픈 웨이트(open-weight) 이미지 모델로, 업스케일러 없이 약 16메가픽셀(4096 x 4096) 크기의 이미지를 생성하고 편집할 수 있습니다. MiniMax에 따르면 4K 이미지 한 장을 생성하는 데 약 10초가 걸립니다. MiniMax API를 통해 호출하거나, Hailuo AI와 MiniMax Code에서 사용하거나, Hugging Face에서 가중치를 다운로드할 수 있습니다.
이 가이드에서는 MiniMax H3-Image가 무엇인지, MiniMax가 실제로 어떤 주장을 하는지, 라이선스상 "오픈 웨이트"가 의미하는 바, 출시 주간 할인 기간의 가격, 그리고 코딩 에이전트에서 API를 테스트하는 방법을 설명합니다.
MiniMax H3-Image란 무엇인가?
MiniMax H3-Image는 MiniMax H3 계열의 텍스트-이미지 및 이미지 편집 모델입니다. 하나의 체크포인트로 두 작업을 모두 처리합니다. 즉, 프롬프트로 이미지를 생성하고 최대 16개의 참조 이미지를 편집할 수 있습니다. 4096 x 4096(1:1)부터 6272 x 2688(21:9)까지 어떤 종횡비로도 약 16메가픽셀의 결과물을 출력하며, 가중치는 커뮤니티 라이선스로 공개되어 있습니다.
MiniMax의 X 출시 게시물에서 발표 내용은 간결합니다. "10초 만에 4K 이미지 생성", 1,600만 픽셀, 사실적 표현, 정확한 프롬프트 준수 및 편집, 최대 16개의 참조 이미지, 그리고 오픈 웨이트 공개입니다.
H3-Image는 MiniMax M3 설명서에서 다룬 MiniMax의 코딩 모델과는 별개이며, 자체 API 엔드포인트를 가지고 있습니다.
MiniMax가 H3-Image에 대해 주장하는 것들
다음은 MiniMax가 Hugging Face 모델 카드와 공식 발표에서 밝힌 내용입니다. 속도와 품질 관련 수치는 MiniMax의 주장으로 취급해야 합니다. 이 글을 작성하는 시점에는 회사 외부에서 발표된 독립적인 측정 결과가 없었습니다.
| 주장 | MiniMax의 설명 | 출처 |
|---|---|---|
| 해상도 | 약 16MP, 1:1 기준 4096 x 4096, 21:9 기준 최대 6272 x 2688, 업스케일러 불필요 | 모델 카드 |
| 속도 | 4K 이미지 약 10초 | 출시 게시물 |
| 샘플링 | 6 샘플링 스텝으로 증류, classifier-free guidance 미사용 | 모델 카드 |
| 참조 이미지 | 편집당 최대 16개의 참조 이미지 | 모델 카드, API 가이드 |
| 지시사항 준수 | "오픈소스 모델 중 가장 강력한 지시사항 준수 능력" | 모델 카드 |
| 작동 범위 | 약 4MP~20MP, 16MP 부근에서 최상의 결과 | 모델 카드 |
속도 주장은 6 스텝 증류와 classifier-free guidance 미사용에 기반한 것인데, classifier-free guidance는 보통 스텝당 연산량을 두 배로 늘립니다. MiniMax는 10초라는 수치를 만들어낸 하드웨어를 밝히지 않았으므로, 이를 자신의 GPU에서의 성능 보증으로 받아들이면 안 됩니다.
모델 카드에는 지시사항 준수 능력에 대한 벤치마크 표가 실려 있지 않습니다. 자매 포스트인 MiniMax H3-Image vs Nano Banana 2.1에서 두 모델을 나란히 비교해 봅니다.
모델의 내부 구조
모델 카드는 아키텍처에 대해 이례적으로 구체적으로 밝히고 있습니다:
- Diffusion transformer: 33.1B 파라미터, 50개 레이어를 가진 dense 단일 스트림 트랜스포머, BF16으로 저장(68.65 GB).
- 텍스트 인코더: 변경 없는 MiniMax-H3 텍스트 인코더, 별도의 MiniMax-H3 저장소에서 로드(66.7 GB).
- 이미지 VAE: 16배 공간적 다운샘플링, 24개 잠재 채널(2.34 GB).
- 선택적 프롬프트 확장기: MiniMax-H3-Image-PE(17.9 GB, NVFP4). 모델이 기대하는 상세한 영어 설명으로 짧은 프롬프트를 변환합니다.
이를 모두 합하면, 선택적 확장기를 제외하고도 전체 로컬 설치에 약 137 GB를 다운로드해야 합니다.
MiniMax H3-Image에서 "오픈 웨이트"의 의미
MiniMax H3-Image는 OSI가 정의하는 오픈소스가 아니라 오픈 웨이트 모델입니다. 가중치를 다운로드하고 실행할 수 있지만, MiniMax-H3-Image Community License가 실질적인 제한을 둡니다. 이를 기반으로 개발하기 전에 라이선스를 읽어보세요. 대부분의 팀에 영향을 주는 조항은 다음과 같습니다:
- 지역 제한. 라이선스는 "제외 지역(Excluded Territories)"을 제외한 전 세계에서 권한을 부여합니다. 제외 지역은 유럽연합, 영국, 대한민국, 미국입니다. 이 지역의 팀은 별도 라이선스에 대해 MiniMax에 문의해야 합니다.
- 매출 및 호스팅. 본인 및 계열사의 연환산 매출이 100만 달러를 초과하거나, 제3자에게 모델을 호스팅 서비스로 제공하는 경우 MiniMax의 사전 서면 승인이 필요합니다. 요청은 MiniMax의 라이선스 콘솔을 통해 제출합니다.
- 귀속 표기. 상업적 제품은 사용자 인터페이스에 "MiniMax-H3-Image"를 눈에 띄게 표시해야 합니다.
- 다른 모델 학습 금지. 모델이나 그 출력물을 사용해 다른 AI 모델을 개선할 수 없습니다.
- 공개 의무. 허용 사용 정책은 기계 생성 콘텐츠임을 명확히 밝히지 않고 생성 콘텐츠를 공개적으로 게시하는 것을 금지합니다.
MiniMax는 사용자가 생성한 이미지에 대한 권리를 주장하지 않습니다. 호스팅 API만 호출하는 경우에도 해당 용도에 관한 MiniMax의 플랫폼 약관을 확인하세요.
MiniMax H3-Image를 사용할 수 있는 곳
네 가지 경로가 있습니다:
- MiniMax API. 텍스트-이미지 생성은
POST https://api.minimax.io/v1/images/generations에서, 편집은/v1/images/edits에서 처리하며, 모두 모델 ID로MiniMax-H3-Image또는 더 빠른MiniMax-H3-Image-Highspeed를 사용합니다. 전체 워크스루는 MiniMax H3-Image API 가이드에 있습니다. - Hailuo AI. 코드가 필요 없는 MiniMax의 웹 앱입니다.
- MiniMax Code. macOS와 Windows용 MiniMax 데스크톱 앱으로, 출시 게시물에서 H3-Image 사용처로 언급되었습니다.
- 셀프 호스팅. MiniMax는 SGLang, vLLM-Omni, diffusers 또는 ComfyUI를 권장하며, 지원 가속기로 NVIDIA H200, RTX PRO 6000 Blackwell, AMD Instinct MI350X를 나열하고 있습니다. 모델 카드에는 최소 VRAM 수치가 명시되어 있지 않습니다.
무료로 사용할 수 있는 경로를 찾고 있다면 MiniMax H3-Image 무료 사용법 포스트를 참고하세요.
MiniMax H3-Image API 작동 방식
이 API는 OpenAI 스타일의 이미지 형식을 따르므로 요청이 짧습니다:
curl https://api.minimax.io/v1/images/generations \
-H "Authorization: Bearer $MINIMAX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3-Image",
"prompt": "An orange cat on a sunny windowsill, film texture",
"aspect_ratio": "16:9",
"area": "4K",
"response_format": "url"
}'
API 레퍼런스에서 알아두면 유용한 파라미터는 다음과 같습니다:
size는WIDTHxHEIGHT(655,360~20,000,000 픽셀, 종횡비 1:3~3:1) 또는auto를 받습니다.auto를 사용하면 대신aspect_ratio와area(1K,2K,4K, 기본값4K)를 지정합니다. 두 형식을 혼용하면 400이 반환됩니다.n은 요청당 1~10개의 이미지를 생성합니다.output_format은 기본값이jpeg이며,png나webp도 가능합니다.response_format은url(직접 다운로드해야 하며, URL이 유지된다는 보장은 없음) 또는b64_json입니다.stream: true는 각 이미지가 완성되는 대로 서버 전송 이벤트로 밀어줍니다.- 프롬프트 향상 기능은 기본적으로 켜져 있습니다. 각 결과에는 모델이 실제로 사용한 내용을 보여주는
revised_prompt가 포함됩니다. 프롬프트를 그대로 보내려면disable_prompt_enhanced: true로 설정하세요.
사람들이 실수하기 쉬운 동작이 하나 있습니다. 하나 이상의 이미지가 성공하면 다른 이미지가 콘텐츠 안전 검사에서 실패했더라도 호출은 HTTP 200을 반환합니다. 항목마다 data[].error를 확인하세요. 성공한 이미지에 대해서만 과금됩니다.
가이드는 지원되지 않는 기능도 나열합니다: 미리보기 이미지, 마스크 편집, 투명 배경이 그것입니다.
편집 시에는 1~16개의 참조 이미지를 공개 URL, 업로드된 파일 ID 또는 데이터 URI로 전달하며, 요청당 총 64 MiB까지 가능합니다. 프롬프트에서는 업로드 순서대로 <Picture 1>, <Picture 2> 등으로 참조합니다.
MiniMax H3-Image 가격과 출시 주간 할인
MiniMax는 H3-Image를 텍스트 입력, 이미지 입력, 이미지 출력으로 나누어 백만 토큰당 과금합니다. 2026년 11월 11일 기준 MiniMax 가격 페이지의 내용은 다음과 같습니다:
| 모델 | 입력 텍스트 / 백만 토큰 | 입력 이미지 / 백만 토큰 | 출력 이미지 / 백만 토큰 |
|---|---|---|---|
| MiniMax-H3-Image | $2.30 | $1.50 | $3.80 |
| MiniMax-H3-Image-Highspeed | $2.30 | $3.00 | $7.60 |
MiniMax가 제시한 표준 모델 기준 텍스트-이미지 생성당 비용 예시는 1K에서 $0.02179, 2K에서 $0.02333, 4K에서 $0.06879입니다. Highspeed 4K 예시는 $0.13001입니다.
출시 할인은 전달된 이미지가 16,600,000 픽셀 이상일 경우 두 모델 모두에 대해 요청 총 비용에서 50% 할인입니다. 할인은 2026년 11월 17일 16:00 UTC까지 진행됩니다. 이 기간 동안 MiniMax는 표준 4K 텍스트-이미지 생성 결과를 $0.03439로, Highspeed 결과를 $0.06501로 안내합니다. 더 작은 이미지는 할인 대상이 아니므로 2K 렌더링 비용은 이전과 동일합니다.
Apidog CLI로 MiniMax H3-Image API 테스트하기
앱에 H3-Image를 통합하기 전에, "실패한 항목이 있어도 200이 반환되는" 경우를 포함해 요청 형식, 인증, 오류 처리가 제대로 작동하는지 확인하세요. 요청을 수작업으로 클릭해가며 테스트하는 대신, 코딩 에이전트가 Apidog CLI로 이 검증을 구축하고 실행하도록 하세요.
![워크플로 다이어그램: 코딩 에이전트가 Apidog CLI로 엔드포인트와 테스트 케이스를 생성하고, MiniMax H3-Image의 POST /v1/images/generations를 호출하며, 상태 200, data[0].url 존재, data[].error 없음을 검사하는 테스트 리포트를 읽은 뒤 수정하고 재실행하는 과정](https://assets.apidog.com/blog-next/2026/11/minimax-h3-apidog-loop.png)
CLI를 한 번만 설정하세요:
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_APIDOG_TOKEN>
apidog skill install
이 스킬은 CLI 명령어를 에이전트(Claude Code, Codex, Cursor 등)에게 가르쳐 줍니다. 그다음 프롬프트 하나를 주면 됩니다:
In Apidog project <projectId>, add the MiniMax H3-Image endpoint
POST /v1/images/generations from https://platform.minimax.io/docs/api-reference/image-generation-h3-generations
with Bearer auth from {{MINIMAX_API_KEY}}. Create an environment with base URL
https://api.minimax.io. Write a test case that sends model MiniMax-H3-Image,
area 1K, n 1, and asserts status 200, data[0].url exists, data[0].error is absent
and usage.generated_images equals 1. Run it and summarize the result.
에이전트는 이를 짧은 apidog 명령어 실행으로 변환합니다. 아래의 모든 플래그는 Apidog CLI 2.2.12의 apidog <command> --help에서 확인한 것입니다:
apidog environment create --project <projectId> --base-url https://api.minimax.io
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file ./h3-endpoint.json
apidog endpoint create --project <projectId> --file ./h3-endpoint.json
apidog test-case category --project <projectId>
apidog cli-schema validate test-case-create --file ./h3-case.json
apidog test-case create --project <projectId> --file ./h3-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> \
--env-var "MINIMAX_API_KEY=$MINIMAX_API_KEY" -r cli,json
cli-schema get은 에이전트에게 정확한 JSON 형식을 전달하고, cli-schema validate는 무언가가 기록되기 전에 각 파일을 검사합니다. test-case category는 유효한 카테고리 ID를 제공해 케이스가 앱에 표시되도록 합니다. 실행 결과는 터미널에 통과/실패 요약을 출력하고, 에이전트가 무엇을 수정할지 판단하는 데 사용하는 JSON 리포트를 작성합니다. --upload-report를 추가하면 Apidog에서 동일한 실행 결과를 볼 수 있습니다.
area: 1K를 사용하면 각 테스트 호출을 MiniMax가 안내하는 가장 낮은 예시 가격 수준으로 유지할 수 있습니다. 이 패턴에 대한 자세한 내용은 Apidog CLI 에이전트 워크플로와 Claude Code에서의 Apidog CLI 가이드를 참고하세요. Apidog의 무료 플랜은 최대 4명의 사용자까지 지원합니다.
MiniMax H3-Image를 사용해봐야 할까?
큰 크기의 상세한 이미지가 필요하고 오픈 웨이트 옵션을 원하거나, 멀티 참조 편집(제품 사진, 실내 레이아웃, 캐릭터 시트 등)이 주요 용도라면 사용해 보세요. 출시 할인 덕분에 11월 17일까지는 4K 테스트가 저렴합니다.
셀프 호스팅은 신중하게 고려하세요. 약 137 GB의 가중치, 데이터센터급 GPU, 그리고 EU, 영국, 대한민국, 미국을 제외하는 라이선스가 걸려 있습니다. 대부분의 팀에게 API가 현실적인 경로입니다. 이미지 API를 비교 중이라면, GPT Image 2.6 API, Nano Banana 2.1 API, Qwen-Image 2.1 가이드에서 대안을 확인할 수 있습니다.
FAQ
MiniMax H3-Image는 무료인가요? 라이선스의 지역 내에서, 매출 및 호스팅 제한 조건에 따라 가중치를 로열티 없이 다운로드하고 실행할 수 있습니다. API는 토큰당 유료입니다. 무료 이용 경로는 무료 접근 가이드를 참고하세요.
MiniMax H3-Image는 오픈소스인가요? MiniMax는 Hugging Face에서 오픈소스라고 부르지만, 지역, 매출, 귀속 표기, 학습 금지 제한이 있는 커스텀 커뮤니티 라이선스로 배포됩니다. "오픈 웨이트"가 더 정확한 용어입니다.
MiniMax H3-Image는 얼마나 빠른가요? MiniMax는 4K 이미지에 약 10초가 걸린다고 합니다. 이는 회사 발표 수치이며, 하드웨어를 밝히지 않았고 이 글 작성 시점에는 독립적인 벤치마크가 존재하지 않았습니다.
MiniMax-H3-Image와 MiniMax-H3-Image-Highspeed의 차이는 무엇인가요? 두 모델 모두 동일한 파라미터와 제한을 사용합니다. Highspeed는 더 빠른 티어이며 비용이 더 높습니다. 출력 이미지 토큰 백만 개당 $7.60으로, $3.80의 두 배입니다.
MiniMax H3-Image는 참조 이미지를 몇 개까지 사용할 수 있나요? 편집 요청당 최대 16개까지 가능하며, 각 이미지는 한 변 128~8,192 픽셀이어야 하고 전체 요청 본문은 64 MiB로 제한됩니다.
MiniMax H3-Image 출시 할인은 언제 끝나나요? 2026년 11월 17일 16:00 UTC입니다. 16,600,000 픽셀 이상의 이미지에만 적용됩니다.