MiniMax H3 Image API — text-to-image and editing with up to 16 reference images, 1K to 4K
minimax-h3-imageO MiniMax H3 Image é o modelo de geração de imagens da MiniMax, disponível no apimodels.app como minimax-h3-image com uma única API key (a grafia MiniMax-H3-Image também é aceita). Um só modelo cria imagens a partir de texto e as edita: envie apenas o prompt para gerar, ou acrescente de 1 a 16 imagens de referência, que o prompt pode chamar de imagem 1, imagem 2 e assim por diante, para alterar parte de uma foto, mudar o estilo ou juntar várias imagens em uma. Cada pedido devolve de 1 a 10 imagens. O tamanho é definido de uma de duas maneiras: por um nível de área, 1K, 2K ou 4K (2K por padrão), com auto ou qualquer proporção entre 1:3 e 3:1, ou por um tamanho exato entre 655.360 e 20.000.000 pixels. A saída é JPEG por padrão, ou PNG e WebP quando solicitado. Em texto para imagem, o prompt passa pelo aprimoramento automático do modelo, a menos que você o desligue com disable_prompt_enhanced; nas edições ele fica sempre ativo. Nos nossos testes, um pedido de texto para imagem em 1K e 16:9 levou cerca de 10 segundos e devolveu 1360×768, e uma edição em 1K com uma imagem de referência levou cerca de 16 segundos. Preço: $0.03 por imagem em 1K ou 2K e $0.10 em 4K (tamanhos personalizados acima de cerca de 5 megapixels contam como 4K), mais $0.01 por imagem de referência; só são cobradas as imagens efetivamente entregues, e um pedido que falha não custa nada. Referências acima de cerca de 2,4 megapixels são reduzidas proporcionalmente antes do envio. Nem todo pedido dá certo: a moderação de conteúdo pode recusar um prompt ou uma imagem. Máscaras, fundo transparente, negative_prompt e seed não são suportados e retornam 400 em vez de serem ignorados em silêncio. Para resultados mais rápidos, com preço maior, use o minimax-h3-image-highspeed.
Generate Image
Result
Generated image will appear here
Enter a prompt and click Generate
Criar e editar com um só modelo
Só um prompt para gerar a partir de texto, ou um prompt com 1–16 imagens de referência (image 1, image 2… no prompt) para alterar parte de uma foto, mudar o estilo ou juntar várias numa só
1K, 2K ou 4K, proporções de 1:3 a 3:1
Você escolhe um nível de área (2K por padrão) com auto ou qualquer proporção X:Y, ou passa um tamanho exato entre 655,360 e 20,000,000 pixels. Saída em JPEG, PNG ou WebP
1–10 imagens por pedido
Com n até 10, todas voltam na mesma resposta; você paga só pelas imagens entregues
$0.03 / $0.10 por imagem
1K ou 2K a $0.03 e 4K a $0.10 (tamanhos próprios acima de uns 5 MP contam como 4K), mais $0.01 por imagem de referência
Limites
Sem máscaras, fundo transparente, negative prompt ou seed: eles retornam 400 em vez de serem ignorados. Até 16 imagens de referência, cada uma com 128–8192 px por lado e no máximo 4:1; as que passam de uns 2.4 MP são reduzidas antes do envio
Não acerta 100%, mas falha não é cobrada
Nem todo pedido dá certo: a revisão de conteúdo pode recusar um prompt ou uma imagem. Um pedido que falha informa o motivo e não custa nada
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" } }Sobre MiniMax H3 Image
MiniMax H3 Image é uma API de geração de imagens da MiniMax. O MiniMax H3 Image é o modelo de geração de imagens da MiniMax, disponível no apimodels.app como minimax-h3-image com uma única API key (a grafia MiniMax-H3-Image também é aceita). Um só modelo cria imagens a partir de texto e as edita: envie apenas o prompt para gerar, ou acrescente de 1 a 16 imagens de referência, que o prompt pode chamar de imagem 1, imagem 2 e assim por diante, para alterar parte de uma foto, mudar o estilo ou juntar várias imagens em uma. Cada pedido devolve de 1 a 10 imagens. O tamanho é definido de uma de duas maneiras: por um nível de área, 1K, 2K ou 4K (2K por padrão), com auto ou qualquer proporção entre 1:3 e 3:1, ou por um tamanho exato entre 655.360 e 20.000.000 pixels. A saída é JPEG por padrão, ou PNG e WebP quando solicitado. Em texto para imagem, o prompt passa pelo aprimoramento automático do modelo, a menos que você o desligue com disable_prompt_enhanced; nas edições ele fica sempre ativo. Nos nossos testes, um pedido de texto para imagem em 1K e 16:9 levou cerca de 10 segundos e devolveu 1360×768, e uma edição em 1K com uma imagem de referência levou cerca de 16 segundos. Preço: $0.03 por imagem em 1K ou 2K e $0.10 em 4K (tamanhos personalizados acima de cerca de 5 megapixels contam como 4K), mais $0.01 por imagem de referência; só são cobradas as imagens efetivamente entregues, e um pedido que falha não custa nada. Referências acima de cerca de 2,4 megapixels são reduzidas proporcionalmente antes do envio. Nem todo pedido dá certo: a moderação de conteúdo pode recusar um prompt ou uma imagem. Máscaras, fundo transparente, negative_prompt e seed não são suportados e retornam 400 em vez de serem ignorados em silêncio. Para resultados mais rápidos, com preço maior, use o minimax-h3-image-highspeed. Pela plataforma APIMODELS, você acessa este modelo por uma API unificada com preços transparentes de pagamento por uso. Preço atual: 1K: $0.03, 2K: $0.03, 4K: $0.1, Each reference image: +$0.01.
Principais recursos
- Criar e editar com um só modelo -- Só um prompt para gerar a partir de texto, ou um prompt com 1–16 imagens de referência (image 1, image 2… no prompt) para alterar parte de uma foto, mudar o estilo ou juntar várias numa só
- 1K, 2K ou 4K, proporções de 1:3 a 3:1 -- Você escolhe um nível de área (2K por padrão) com auto ou qualquer proporção X:Y, ou passa um tamanho exato entre 655,360 e 20,000,000 pixels. Saída em JPEG, PNG ou WebP
- 1–10 imagens por pedido -- Com n até 10, todas voltam na mesma resposta; você paga só pelas imagens entregues
- $0.03 / $0.10 por imagem -- 1K ou 2K a $0.03 e 4K a $0.10 (tamanhos próprios acima de uns 5 MP contam como 4K), mais $0.01 por imagem de referência
- Limites -- Sem máscaras, fundo transparente, negative prompt ou seed: eles retornam 400 em vez de serem ignorados. Até 16 imagens de referência, cada uma com 128–8192 px por lado e no máximo 4:1; as que passam de uns 2.4 MP são reduzidas antes do envio
- Não acerta 100%, mas falha não é cobrada -- Nem todo pedido dá certo: a revisão de conteúdo pode recusar um prompt ou uma imagem. Um pedido que falha informa o motivo e não custa nada
Exemplos por cenário
Casos de uso
Imagens de produto para e-commerce
Gere imagens de produto de alta qualidade para lojas online, anúncios e material de marketing.
Conteúdo para redes sociais
Crie conteúdo visual atraente para redes sociais e aumente o engajamento e a visibilidade da marca.
Recursos para jogos
Produza arte conceitual de personagens, cenários e objetos para acelerar o desenvolvimento de jogos.
Material de marketing
Crie pôsteres, banners e peças promocionais por uma fração do custo tradicional.
Por que a APIMODELS
- API unificada -- Uma única chave para todos os modelos, sem se cadastrar em várias plataformas
- Preços transparentes -- Pagamento por uso com o preço por chamada publicado em cada página de modelo, ideal para desenvolvedores independentes e startups
- Acesso instantâneo -- Comece logo após o cadastro; pague com cartão, PayPal, Alipay ou USDT
- Documentação completa -- Documentação de API detalhada com exemplos em cURL, Python e Node.js
Perguntas frequentes
Qual a diferença entre a APIMODELS e a API oficial da MiniMax?
A APIMODELS oferece o mesmo modelo MiniMax H3 Image pela nossa plataforma de agregação. Fornecemos uma interface de API unificada, então você não precisa de contas separadas por provedor: uma única chave para acessar todos os modelos.
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.
Como o MiniMax H3 Image se compara a outros modelos da mesma categoria?
Na APIMODELS, o MiniMax H3 Image roda junto com mais de 60 modelos usando uma única chave de API e um único saldo, então escolher é questão de adequação, não de dependência. Ele suporta 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 e você pode avaliá-lo em preço e capacidade frente a outros modelos da mesma categoria (geração de imagens), trocando ao alterar uma única string com o nome do modelo — sem nova conta ou integração. Veja todos os modelos dessa categoria com preços ao vivo em apimodels.app/models.
O que o MiniMax H3 Image pode fazer?
O MiniMax H3 Image suporta: 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. Consulte a documentação da APIMODELS para todos os parâmetros e exemplos de chamada.
Posso usar a API do MiniMax H3 Image de qualquer país?
Sim. A APIMODELS não restringe o acesso por país: o site e a API respondem de qualquer lugar, e apimodels.app e api.apimodels.app também podem ser acessados diretamente da China continental, sem proxy. Você chama o MiniMax H3 Image com uma única chave da APIMODELS, sem precisar de conta separada com o desenvolvedor do modelo.
Posso pagar com PayPal ou cripto? Quais formas de pagamento são aceitas?
Pode. Dá para recarregar com PayPal, USDT na TRON (TRC20) ou na BNB Smart Chain (BEP20), cartão (Visa, Mastercard e outros, via Stripe) ou Alipay. Recargas com cartão, PayPal e Alipay caem na hora; as de USDT, assim que a transferência é confirmada na rede. Também dá para ativar a recarga automática, e uma recarga de $50 ganha $1 de bônus ($3 na de $100). O saldo é em dólar e cobrado por uso, sem assinatura.