MiniMax H3 Image Highspeed

MiniMax H3 Image Highspeed (ID oficial MiniMax-H3-Image-Highspeed, slug na RouteMux minimax/minimax-h3-image-highspeed) é a versão de baixa latência da linha MiniMax H3 Image, projetada para criação interativa em tempo real e iteração rápida. Ela mantém exatamente o mesmo teto de capacidades da versão padrão minimax/minimax-h3-image: geração de texto para imagem em 1K, 2K e 4K nativo (até cerca de 16 megapixels) e edição com até 16 imagens de referência. Tarefas em lote podem usar a versão padrão minimax/minimax-h3-image para menor custo; quando o usuário aguarda a imagem na tela, escolha esta versão Highspeed.

Na RouteMux, ela funciona pelo protocolo compatível com OpenAI Images: envie requisições texto-para-imagem para POST https://api.routemux.com/v1/images/generations e edição com referências 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 aceita de 1 a 16 imagens de referência via array JSON images (cada item com image_url) ou multipart em image ou image[]; máscara local (mask) e streaming (stream deve ser omitido ou false) não são suportados.

Há duas maneiras de definir dimensões: combinar area ("1K", "2K" ou "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 informar as dimensões 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 de prompt vem ativada por padrão em texto-para-imagem; se disable_prompt_enhanced for true, é obrigatório informar size em formato WxH ou aspect_ratio em formato X:Y (a edição de imagens não suporta desativar a expansão). 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 é não idempotente (non_idempotent), a cobrança de tokens começa assim que o provedor inicia a geração. O gateway da RouteMux só repete a chamada deste modelo quando o provedor retorna HTTP 429; erros 5xx, timeouts e falhas de rede nunca são repetidos. No cliente, defina max_retries=0 no SDK da OpenAI e não passe --retry no curl para evitar cobrança em dobro.