MiniMax H3 Image API — text-to-image and editing with up to 16 reference images, 1K to 4K
minimax-h3-imageMiniMax H3 Image는 MiniMax의 이미지 생성 모델로, apimodels.app에서는 API 키 하나로 minimax-h3-image라는 이름으로 호출합니다(MiniMax 표기인 MiniMax-H3-Image도 됩니다). 모델 하나로 텍스트→이미지와 이미지 편집을 모두 처리합니다. 프롬프트만 보내면 텍스트로 이미지를 만들고, 참조 이미지를 1~16장 더하면 사진 일부를 바꾸거나 스타일을 바꾸거나 여러 장을 한 장으로 합칩니다. 참조 이미지는 프롬프트에서 이미지 1, 이미지 2처럼 가리킬 수 있습니다. 요청 한 번에 1~10장을 생성합니다. 크기는 두 가지 방식 중 하나로 정합니다. 면적 단계 1K·2K·4K(기본 2K)에 auto 또는 1:3부터 3:1 사이의 원하는 비율을 함께 주거나, 655,360~20,000,000픽셀 범위의 정확한 크기를 지정합니다. 출력은 기본 JPEG이고 요청하면 PNG나 WebP로 받을 수 있습니다. 텍스트→이미지에서는 모델의 프롬프트 보강이 기본으로 적용되며 disable_prompt_enhanced로 끌 수 있고, 편집에서는 항상 적용됩니다. 저희 테스트에서 1K 16:9 텍스트→이미지 요청은 약 10초 만에 1360×768을 돌려주었고, 참조 이미지 한 장으로 한 1K 편집은 약 16초가 걸렸습니다. 가격은 1K·2K 장당 $0.03, 4K $0.10이며(약 500만 화소를 넘는 사용자 지정 크기는 4K로 계산), 참조 이미지 한 장마다 $0.01이 더해집니다. 실제로 전달된 이미지만 과금되고, 실패한 요청은 비용이 들지 않습니다. 약 240만 화소를 넘는 참조 이미지는 보내기 전에 비율을 유지한 채 줄입니다. 모든 요청이 성공하지는 않으며, 콘텐츠 검토에서 프롬프트나 이미지가 거절될 수 있습니다. 마스크, 투명 배경, negative_prompt, seed는 지원하지 않으며 조용히 무시하지 않고 400을 반환합니다. 더 빠른 출력이 필요하면 가격은 높지만 minimax-h3-image-highspeed를 쓰세요.
Generate Image
Result
Generated image will appear here
Enter a prompt and click Generate
모델 하나로 생성과 편집
프롬프트만 보내면 텍스트로 생성하고, 참조 이미지 1–16장을 더하면(프롬프트에서는 image 1, image 2…) 사진 일부 수정, 스타일 변경, 여러 장 합성까지 할 수 있습니다
1K·2K·4K, 비율 1:3~3:1
면적 단계(기본 2K)에 auto 또는 원하는 X:Y를 고르거나, 655,360~20,000,000픽셀 사이의 정확한 크기를 지정합니다. 출력은 JPEG, PNG, WebP
요청당 1–10장
n은 최대 10이며 한 응답에 모두 돌아옵니다. 실제로 생성된 이미지만 과금됩니다
장당 $0.03 / $0.10
1K·2K $0.03, 4K $0.10(약 5 MP를 넘는 직접 지정 크기는 4K로 계산), 참조 이미지 한 장마다 $0.01
제한 사항
마스크, 투명 배경, 네거티브 프롬프트, seed는 지원하지 않으며 조용히 무시하지 않고 400을 반환합니다. 참조 이미지는 최대 16장, 장마다 한 변 128–8192 px, 비율 4:1 이내이고, 약 2.4 MP를 넘으면 줄여서 보냅니다
100% 성공은 아니지만 실패는 무료
모든 요청이 성공하지는 않으며, 콘텐츠 심사에서 프롬프트나 이미지가 거절될 수 있습니다. 실패한 요청은 이유를 알려 주고 과금되지 않습니다
MiniMax H3 Image API: text-to-image and editing with up to 16 reference images, 1K to 4K
MiniMax H3 Image is MiniMax's image generation model. Send a prompt and get 1 to 10 images, or add up to 16 reference images to change part of a photo, restyle it or combine several pictures into one. Sizes run from 1K to 4K in any shape from 1:3 to 3:1.
On APIMODELS it is one model id, minimax-h3-image, on POST /v1/images/generations: $0.03 per image at 1K or 2K, $0.10 at 4K, plus $0.01 per reference image. It has no masks, no transparent background and no seed, and not every request succeeds; the limits are listed below.
- Model ID
minimax-h3-image- Input
- Text prompt, plus up to 16 reference images (optional)
- Output
- 1–10 images, 1K / 2K / 4K (default 2K)
- Aspect ratio
- auto or any ratio from 1:3 to 3:1
- Price
- $0.03 (1K / 2K), $0.10 (4K), +$0.01 per reference
MiniMax H3 Image API limits at a glance
What the model accepts and what it does not. Unsupported inputs return a 400 before anything is generated, instead of being silently ignored, so you never pay for an image that skipped part of your request.
| Supported | Not supported | |
|---|---|---|
| Input | A text prompt of up to 32,000 characters, alone or with 1 to 16 reference images for editing, restyling or combining pictures (image 1, image 2… in the prompt) | Masks (inpainting) |
| Reference images | 1 to 16 (+$0.01 each), as public URLs or base64 data URIs; each 128–8192 px per side, the long side at most 4× the short side, up to 64 MB. Anything above about 2.4 MP is scaled down before it is sent | More than 16; images outside those sizes (400) |
| Images per request | 1 to 10 (n); only images actually delivered are charged | n above 10 (400) |
| Size | resolution 1K, 2K or 4K (2K by default) with aspect_ratio auto or any X:Y from 1:3 to 3:1; or an exact size WIDTHxHEIGHT between 655,360 and 20,000,000 pixels | Shapes beyond 1:3 or 3:1; exact sizes outside that pixel range (400) |
| Output format | JPEG by default; PNG or WebP with output_format | Transparent background (background: transparent returns 400) |
| Prompt enhancement | On by default. For text-to-image, disable_prompt_enhanced: true turns it off when you also set aspect_ratio or size | Turning it off for edits (edits always use it) |
| Other controls | aigc_watermark (true / false) | negative_prompt and seed (400; results are not repeatable) |
Not every MiniMax H3 Image request succeeds
Like every image model, it does not succeed 100% of the time. You are charged only for images that are delivered.
A request can fail after it is accepted: content review can refuse the prompt or a reference image, and a generation can hit a temporary error. A failed request returns the reason and costs nothing. When you ask for several images and only some come back, you pay only for those.
Our five test requests on 11 November 2026 all returned images, which is far too few to promise a success rate, so we do not publish one. At 1K they took 6 to 16 seconds; 4K, several images per request and many reference images take longer, so give the call a generous timeout. Build in retries for temporary errors and rewrite refused prompts.
MiniMax H3 Image API pricing
Per output image by size tier, plus a fixed amount per reference image. The text prompt is free.
| minimax-h3-image | minimax-h3-image-highspeed | |
|---|---|---|
| Each output image · 1K or 2K | $0.03 | $0.05 |
| Each output image · 4K | $0.10 | $0.18 |
| Each reference image | +$0.01 | +$0.015 |
| Exact size (size WIDTHxHEIGHT) | Up to 5,033,165 pixels at the 1K / 2K price, above that at the 4K price | Same rule |
2K text-to-image, 1 image
$0.03
1 × $0.03
2K edit with 2 reference images, 1 image
$0.05
$0.03 + 2 × $0.01
4 variations at 2K in one request
$0.12
4 × $0.03; if only 3 come back, $0.09
4K poster, 1 image
$0.10
1 × $0.10
Standard or Highspeed?
Both tiers take exactly the same request: the same fields, the same limits and the same responses. Only the model id, the speed and the price differ, so you can switch with one string.
| minimax-h3-image | minimax-h3-image-highspeed | |
|---|---|---|
| Our 1K 16:9 test (one request each) | Text-to-image about 10 s; edit with one reference about 16 s | Poster with two text lines about 6 s |
| 1K / 2K · 4K · each reference | $0.03 · $0.10 · +$0.01 | $0.05 · $0.18 · +$0.015 |
| Use it for | Batch jobs and pipelines where nobody is waiting on the picture | Interactive apps where a user is waiting for the result |
When MiniMax H3 Image is a good fit, and when it is not
Edits that pull from many pictures
Up to 16 reference images in one request: a product, a model, a background and a style board, referred to as image 1, image 2 and so on.
Several variations at once
n up to 10 in one call, and only the images that come back are charged.
Large sizes and wide shapes
4K, or an exact size up to 20 megapixels, in any shape from 1:3 to 3:1.
Masked inpainting
There are no masks. Describe the change in the prompt and pass the picture as a reference image instead.
Transparent assets
No transparent background. For PNGs with a real alpha channel, use doubao-seedream-5-5 with background: "transparent".
Repeatable results
There is no seed, so the same request returns a different picture each time.
Call it in one request
POST /v1/images/generations with your apimodels.app API key. By default you get a taskId back and poll GET /v1/images/generations?task_id= (or pass a callback_url); with a WIDTHxHEIGHT size or the OpenAI SDK, the images come back in the same response. Full field list in the docs.
curl -X POST https://api.apimodels.app/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "Replace the croissant on the plate with a slice of strawberry cheesecake. Keep the cup, saucer, latte art, steam, table, window light and everything else exactly the same.",
"image": "https://example.com/cafe.jpg",
"resolution": "2K",
"aspect_ratio": "16:9"
}'
# → { "code": 200, "data": { "taskId": "...", "state": "pending", "model": "minimax-h3-image" } }MiniMax H3 Image 소개
MiniMax H3 Image 모델은 MiniMax의 이미지 생성 API입니다. MiniMax H3 Image는 MiniMax의 이미지 생성 모델로, apimodels.app에서는 API 키 하나로 minimax-h3-image라는 이름으로 호출합니다(MiniMax 표기인 MiniMax-H3-Image도 됩니다). 모델 하나로 텍스트→이미지와 이미지 편집을 모두 처리합니다. 프롬프트만 보내면 텍스트로 이미지를 만들고, 참조 이미지를 1~16장 더하면 사진 일부를 바꾸거나 스타일을 바꾸거나 여러 장을 한 장으로 합칩니다. 참조 이미지는 프롬프트에서 이미지 1, 이미지 2처럼 가리킬 수 있습니다. 요청 한 번에 1~10장을 생성합니다. 크기는 두 가지 방식 중 하나로 정합니다. 면적 단계 1K·2K·4K(기본 2K)에 auto 또는 1:3부터 3:1 사이의 원하는 비율을 함께 주거나, 655,360~20,000,000픽셀 범위의 정확한 크기를 지정합니다. 출력은 기본 JPEG이고 요청하면 PNG나 WebP로 받을 수 있습니다. 텍스트→이미지에서는 모델의 프롬프트 보강이 기본으로 적용되며 disable_prompt_enhanced로 끌 수 있고, 편집에서는 항상 적용됩니다. 저희 테스트에서 1K 16:9 텍스트→이미지 요청은 약 10초 만에 1360×768을 돌려주었고, 참조 이미지 한 장으로 한 1K 편집은 약 16초가 걸렸습니다. 가격은 1K·2K 장당 $0.03, 4K $0.10이며(약 500만 화소를 넘는 사용자 지정 크기는 4K로 계산), 참조 이미지 한 장마다 $0.01이 더해집니다. 실제로 전달된 이미지만 과금되고, 실패한 요청은 비용이 들지 않습니다. 약 240만 화소를 넘는 참조 이미지는 보내기 전에 비율을 유지한 채 줄입니다. 모든 요청이 성공하지는 않으며, 콘텐츠 검토에서 프롬프트나 이미지가 거절될 수 있습니다. 마스크, 투명 배경, negative_prompt, seed는 지원하지 않으며 조용히 무시하지 않고 400을 반환합니다. 더 빠른 출력이 필요하면 가격은 높지만 minimax-h3-image-highspeed를 쓰세요. APIMODELS 플랫폼을 거치면 통합 API와 투명한 종량 과금으로 이 모델을 호출할 수 있습니다. 현재 가격: 1K: $0.03, 2K: $0.03, 4K: $0.1, Each reference image: +$0.01.
주요 기능
- 모델 하나로 생성과 편집 -- 프롬프트만 보내면 텍스트로 생성하고, 참조 이미지 1–16장을 더하면(프롬프트에서는 image 1, image 2…) 사진 일부 수정, 스타일 변경, 여러 장 합성까지 할 수 있습니다
- 1K·2K·4K, 비율 1:3~3:1 -- 면적 단계(기본 2K)에 auto 또는 원하는 X:Y를 고르거나, 655,360~20,000,000픽셀 사이의 정확한 크기를 지정합니다. 출력은 JPEG, PNG, WebP
- 요청당 1–10장 -- n은 최대 10이며 한 응답에 모두 돌아옵니다. 실제로 생성된 이미지만 과금됩니다
- 장당 $0.03 / $0.10 -- 1K·2K $0.03, 4K $0.10(약 5 MP를 넘는 직접 지정 크기는 4K로 계산), 참조 이미지 한 장마다 $0.01
- 제한 사항 -- 마스크, 투명 배경, 네거티브 프롬프트, seed는 지원하지 않으며 조용히 무시하지 않고 400을 반환합니다. 참조 이미지는 최대 16장, 장마다 한 변 128–8192 px, 비율 4:1 이내이고, 약 2.4 MP를 넘으면 줄여서 보냅니다
- 100% 성공은 아니지만 실패는 무료 -- 모든 요청이 성공하지는 않으며, 콘텐츠 심사에서 프롬프트나 이미지가 거절될 수 있습니다. 실패한 요청은 이유를 알려 주고 과금되지 않습니다
Examples by scenario
활용 사례
이커머스 상품 이미지
온라인 스토어와 광고, 마케팅 자료에 쓸 고품질 상품 비주얼을 생성합니다.
SNS 콘텐츠
눈길을 끄는 비주얼을 만들어 참여도와 브랜드 인지도를 끌어올립니다.
게임 에셋 생성
캐릭터와 배경, 소품의 콘셉트 아트를 뽑아 게임 개발의 초반 속도를 높입니다.
마케팅 자료
포스터와 배너, 프로모션 그래픽을 기존 디자인 비용의 일부만으로 준비합니다.
APIMODELS를 쓰는 이유
- 통합 API -- 키 하나로 모든 모델에 접근하며, 플랫폼마다 따로 가입할 필요가 없습니다
- 투명한 가격 -- 종량 과금이고 호출당 단가를 모델 페이지마다 공개합니다. 1인 개발자와 스타트업에 알맞습니다
- 바로 사용 -- 가입 직후부터 쓸 수 있고 카드·PayPal·Alipay·USDT로 결제합니다
- 충실한 문서 -- cURL / Python / Node.js 예제를 갖춘 상세한 API 문서를 제공합니다
자주 묻는 질문
APIMODELS와 MiniMax 공식 API는 무엇이 다른가요?
APIMODELS는 같은 MiniMax H3 Image 모델을 집약 플랫폼을 통해 제공합니다. API 인터페이스가 통합되어 있어 공급자마다 계정을 만들 필요가 없고, 키 하나로 모든 모델에 닿습니다.
How do I call the MiniMax H3 Image API?
Get an API key on apimodels.app and POST to /v1/images/generations with model set to minimax-h3-image (MiniMax's spelling, MiniMax-H3-Image, also works). Send no image for text-to-image, or 1 to 16 reference images (image or images, as URLs or base64) to edit or combine pictures, referring to them in the prompt as image 1, image 2 and so on. By default the call is asynchronous: it returns a taskId that you poll with GET /v1/images/generations?task_id=, or you pass a callback_url. With a WIDTHxHEIGHT size or the OpenAI SDK, the image comes back in the same response. No separate MiniMax account is needed.
How much does the MiniMax H3 Image API cost?
$0.03 per output image at 1K or 2K and $0.10 at 4K, plus $0.01 per reference image; the text prompt is free. A 2K edit with two reference images and one output costs $0.05; four 2K text-to-image outputs in one request cost $0.12. Custom sizes are priced by area: up to about 5.03 megapixels at the 2K price, above that at the 4K price. Only images actually delivered are charged, and a request that fails costs nothing.
Standard or Highspeed (minimax-h3-image-highspeed)?
Both take the same request, fields and limits; they differ in speed and price. We ran one 1K test of each: Highspeed returned a poster in about 6 seconds, the standard model a text-to-image request in about 10 seconds. Highspeed is $0.05 per image at 1K / 2K, $0.18 at 4K and $0.015 per reference image, against $0.03 / $0.10 / $0.01 for the standard model. Use the standard model for batch work that is not waiting on latency, and Highspeed when a user is waiting for the picture.
What are the limits of MiniMax H3 Image?
Prompts up to 32,000 characters; 1 to 10 images per request; up to 16 reference images, each 128 to 8192 pixels per side, the long side at most 4 times the short side and no larger than 64 MB, with anything above about 2.4 megapixels scaled down before it is sent; aspect ratios from 1:3 to 3:1; custom sizes between 655,360 and 20,000,000 pixels. Masks, transparent backgrounds, negative prompts and seeds are not supported and return a 400. Turning off prompt enhancement (disable_prompt_enhanced) works only for text-to-image and needs an aspect ratio or size alongside it.
What size do I get if I do not set one?
A 2K-area image, with the aspect ratio chosen by the model from the prompt (auto). For 1K or 4K pass resolution: "1K" or "4K"; for a fixed shape pass aspect_ratio, for example "16:9"; for exact pixels pass size, for example "2720x1536", in which case resolution and aspect_ratio no longer apply. In our test a 1K 16:9 request returned 1360×768.
What happens when a request fails?
Not every request succeeds: content review can refuse a prompt or an image, and the upstream service occasionally has temporary errors. When you ask for several images, you pay only for the ones delivered; if the whole request fails, nothing is charged and the reserved credit is returned. The response says why it failed: for a review refusal change the prompt or image, for a temporary error simply retry.
MiniMax H3 Image 모델을 같은 이미지 생성 분야의 다른 모델과 비교하면 어떤가요?
APIMODELS에서는 MiniMax H3 Image 모델이 60개가 넘는 모델과 같은 API 키, 같은 잔액 위에 나란히 놓입니다. 그래서 선택은 궁합의 문제이지 종속의 문제가 아닙니다. 주요 기능은 다음과 같습니다: Text to Image、Image Editing · up to 16 Refs、1K / 2K / 4K、Ratios 1:3 to 3:1、1–10 Images per Request、$0.03–$0.10/image. 같은 이미지 생성 분야의 다른 모델과 가격·성능을 나란히 놓고 따져볼 수 있고, 갈아타기는 모델 이름 문자열 하나만 바꾸면 되며 새 계정도 추가 작업도 필요 없습니다. 같은 분야의 선택지와 실시간 가격은 apimodels.app/models에서 볼 수 있습니다.
MiniMax H3 Image 모델로 무엇을 할 수 있나요?
MiniMax H3 Image 모델이 지원하는 기능: Text to Image、Image Editing · up to 16 Refs、1K / 2K / 4K、Ratios 1:3 to 3:1、1–10 Images per Request、$0.03–$0.10/image. 전체 파라미터와 호출 예제는 APIMODELS 문서를 참고하세요.
MiniMax H3 Image API를 한국에서도 바로 쓸 수 있나요?
네. APIMODELS는 국가별 접속 제한을 두지 않아 사이트와 API를 어디서든 쓸 수 있습니다. MiniMax H3 Image 모델은 APIMODELS 키 하나로 호출하므로 모델 제공사 계정을 따로 만들 필요가 없습니다.
결제 수단은 무엇이 있나요? 해외 결제 카드 말고도 되나요?
해외 결제가 되는 카드(Visa, Mastercard 등, Stripe 결제), PayPal, Alipay, USDT(TRON 네트워크 TRC20, BNB Smart Chain 네트워크 BEP20)를 지원합니다. 카드·PayPal·Alipay는 결제 즉시 잔액에 반영되고, USDT는 블록체인에서 송금이 확인된 뒤 반영됩니다. 자동 충전도 켤 수 있으며, $50 충전 시 $1, $100 충전 시 $3의 보너스가 붙습니다. 잔액과 요금은 달러 기준이고 월 구독료 없이 쓴 만큼만 과금됩니다.