# MiniMax H3 Image

> MiniMax H3 Image (ID oficial MiniMax-H3-Image, slug na RouteMux minimax/minimax-h3-image) é o modelo de geração e edição de imagens da MiniMax, com suporte a geração texto-para-imagem e edição baseada em 1 a 16 imagens de referência, três faixas de resolução 1K, 2K e 4K (até cerca de 16 megapixels) ou dimensões personalizadas em pixels, geração de 1 a 10 imagens por chamada e cobrança por token de entrada e saída. A mesma família conta com a versão de alta velocidade minimax/minimax-h3-image-highspeed: ambos compartilham exatamente os mesmos endpoints, parâmetros e limites; a versão padrão é a opção padrão da família para uso diário e tarefas em lote, enquanto a Highspeed entrega geração mais rápida e menor latência.

Canonical: https://routemux.com/pt-BR/minimax/minimax-h3-image
Provider: MiniMax

## Key facts

| Field | Value |
| --- | --- |
| Model ID | minimax/minimax-h3-image |
| Official model ID | MiniMax-H3-Image |
| Input modalities | text, image |
| Output modalities | image |
| Capabilities | Image Generation, Image Edit |
| Upstream release | 2026-11-10 |
| Availability | available |

## Pricing

- RouteMux: $1.9 per 1M tokens
- Official: $3.8 per 1M tokens
- Saving vs official: 50%
- Official price source: https://platform.minimax.io/docs/pricing/overview, verified 2026-11-11

Billing is prepaid wallet, charged per successful request only.

## API access

Base URL: https://api.routemux.com

Supported protocols:

- openai_images

## What is MiniMax H3 Image

MiniMax H3 Image (ID oficial MiniMax-H3-Image, slug na RouteMux minimax/minimax-h3-image) é o modelo de geração e edição de imagens da MiniMax, com suporte a geração texto-para-imagem e edição baseada em 1 a 16 imagens de referência, três faixas de resolução 1K, 2K e 4K (até cerca de 16 megapixels) ou dimensões personalizadas em pixels, geração de 1 a 10 imagens por chamada e cobrança por token de entrada e saída. A mesma família conta com a versão de alta velocidade minimax/minimax-h3-image-highspeed: ambos compartilham exatamente os mesmos endpoints, parâmetros e limites; a versão padrão é a opção padrão da família para uso diário e tarefas em lote, enquanto a Highspeed entrega geração mais rápida e menor latência.

Na RouteMux, o modelo usa o protocolo compatível com OpenAI Images: envie requisições texto-para-imagem para POST https://api.routemux.com/v1/images/generations e requisições de edição para POST https://api.routemux.com/v1/images/edits. O campo prompt aceita até 32000 caracteres Unicode e cada chamada pode gerar de n=1 a 10 imagens. A edição de imagens aceita de 1 a 16 imagens de referência via array JSON images (cada item com image_url) ou upload multipart em image ou image[]; máscara local (mask) e streaming (stream deve ser omitido ou false) não são suportados.

As dimensões podem ser definidas de duas formas: combinando area ("1K", "2K" ou "4K", padrão "4K") com aspect_ratio ("auto" ou X:Y, onde X e Y são inteiros de 1 a 300 com proporção entre 1:3 e 3:1, como 1:1, 16:9, 9:16, 21:9, 3:1 ou 1:3), ou informando o tamanho em pixels em size (WxH com área total entre 655360 e 20000000 pixels e proporção entre 1:3 e 3:1; quando size for WxH, não envie aspect_ratio nem area; size também aceita "auto"). A expansão automática de prompt vem ativada por padrão em texto-para-imagem; se disable_prompt_enhanced for definido como true, é obrigatório informar um size em formato WxH ou um aspect_ratio em formato X:Y (a edição de imagens sempre expande o prompt e não aceita disable_prompt_enhanced=true). O parâmetro output_format aceita "png", "jpeg", "jpg" e "webp", e response_format aceita "url" ou "b64_json". O parâmetro output_compression aceita um inteiro de 0 a 100 (padrão 95) e vale apenas para jpeg e webp. Cada image_url de referência deve ser uma URL https pública ou uma data URL; referências mm_file:// não são aceitas.

Como a geração de imagens é uma operação não idempotente (non_idempotent), o provedor continua gerando e cobrando tokens mesmo se o cliente desconectar ou sofrer timeout, e reenviar a requisição causa geração duplicada e cobrança em dobro. O gateway da RouteMux repete chamadas deste modelo apenas quando o provedor retorna HTTP 429, e não faz retentativas em erros 5xx, timeouts ou erros de rede; no cliente, configure max_retries=0 no SDK da OpenAI (maxRetries: 0 em TypeScript) e não use --retry no curl.

## Key capabilities

- **1K/2K/4K e proporções flexíveis** — Suporta níveis area 1K/2K/4K (até ~16 megapixels) ou dimensões exatas em size (655 mil a 20 milhões de pixels) com proporções de 1:3 a 3:1.
- **Edição com 1 a 16 imagens de referência** — /v1/images/edits aceita de 1 a 16 imagens de referência para edição, gerando de 1 a 10 imagens por chamada tanto na geração quanto na edição.
- **Proteção contra repetição não idempotente** — O gateway só repete quando o provedor retorna 429, sem retentativas em 5xx, timeouts ou erros de rede; defina max_retries=0 (ou maxRetries: 0) no SDK.
- **50% mais barato que o preço oficial** — Cobrado por tokens de texto de entrada, imagem de entrada e imagem gerada na RouteMux com 50% de desconto sobre a tabela oficial da MiniMax.

## Use cases

- **Geração de recursos visuais em alta resolução** — Use area 1K/2K/4K (~16 megapixels) ou dimensões personalizadas WxH em size com proporções de 1:3 a 3:1 e prompts de até 32000 caracteres para gerar imagens em múltiplos formatos.
- **Edição consistente com múltiplas referências** — Passe de 1 a 16 imagens de referência em /v1/images/edits junto com n=1 a 10 para editar mantendo consistência de elementos e comparar variações.

## Other variants in this family

- MiniMax H3 Image Highspeed (`minimax/minimax-h3-image-highspeed`)

## Sources

- [Guia de geração de imagens da MiniMax](https://platform.minimax.io/docs/guides/image-generation)
- [Visão geral de preços da MiniMax](https://platform.minimax.io/docs/pricing/overview)