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.