Para geração direta de texto para imagem em 4K, o MiniMax H3-Image Standard tem um custo de exemplo de $0.06879, abaixo do preço da rota hospedada de terceiros citada neste artigo (WaveSpeed: $0.03 por imagem em 1K/2K e $0.09 em 4K). A própria MiniMax informa latência P50 de 10.3 segundos em 4K no modo Highspeed e 16.0 segundos no Standard, segundo seu gráfico de latência. Já o Highspeed custa $0.13001, acima da opção hospedada; e, para edições com múltiplas referências que precisam manter a identidade, relatos de usuários sugerem procurar outras alternativas.
4K em cerca de 10 segundos, mas as primeiras edições deixam a desejar
O H3-Image é um novo modelo de imagem com pesos abertos, construído sobre o MiniMax H3 de vídeo. Ele gera imagens a partir de texto, trabalha com referências e faz edições, aceitando até 16 imagens de referência e entregando até 10 resultados por solicitação. As faixas de área 1K/2K/4K correspondem a 1,048,576 / 4,194,304 / 16,777,216 pixels; o servidor define largura e altura exatas a partir da proporção e as retorna em data[].size. Portanto, 4K representa uma área-alvo, não necessariamente um quadrado literal de 4096×4096.
A MiniMax divulga números P50 de latência competitivos, embora a comparação em 4K seja limitada. No gráfico de latência P50 da MiniMax, o Highspeed leva 7.7s em 1K e 10.3s em 4K para texto para imagem, contra 10.6s e 16.0s no Standard. Em 4K, a comparação é apenas com o Nano Banana 2.1, que fica entre 50–51s. Assim, a alegação de ser “5x mais rápido que modelos populares” se apoia em uma amostra estreita.
Nos tópicos do Reddit linkados, usuários confirmam a rapidez em T2I, mas apontam duas falhas recorrentes: perda de semelhança nas referências e detalhes pouco definidos na resolução anunciada.
"Infelizmente, ele é muito ruim como modelo ref2i quando comparado ao modelo H3 de vídeo real para ref2i" — u/Omegapepper no r/StableDiffusion
"Talvez as pessoas fiquem bravas comigo, mas, pelo que testei, ele é significativamente inferior ao QI 2.1 [...] para edição com múltiplas referências." — u/Crazy-Repeat-2006 no r/StableDiffusion
No tópico sobre tamanhos recomendados, testadores relatam suavidade e desfoque em imagens que deveriam ser nítidas, mesmo em saídas de alta resolução. Também há debate sobre se a resolução elevada anunciada traz detalhes reais de alta frequência. São relatos iniciais e anedóticos, não um benchmark controlado, mas todos apontam na mesma direção.
O que a API oferece: dois modelos, dois endpoints e expansão de prompt
A documentação da API MiniMax apresenta dois IDs de modelo, dois endpoints de imagem e uma etapa de expansão de prompt.
| Item | MiniMax-H3-Image (Standard) | MiniMax-H3-Image-Highspeed |
|---|---|---|
| Objetivo | Menor custo por imagem | Menor latência |
| Entrada de texto | $2.30 / 1M tokens | $2.30 / 1M tokens |
| Entrada de imagem | $1.50 / 1M tokens | $3.00 / 1M tokens |
| Saída de imagem | $3.80 / 1M tokens | $7.60 / 1M tokens |
Endpoints (o host Global aparece abaixo; contas da China usam o endpoint chinês indicado na mesma documentação):
POST https://api.minimax.io/v1/images/generations— texto para imagem; os parâmetros verificados incluemmodel,prompt(máximo de 32.000 caracteres),disable_prompt_enhanced(padrão false),n(1–10),size(autoouWIDTHxHEIGHT),aspect_ratio,area(1K/2K/4K, padrão4K),output_format(padrão jpeg),response_format(url/b64_json),stream,output_compression.POST /v1/images/edits— edição com 1–16 referências; aceita JPG/PNG/WebP/HEIC/HEIF, com 128–8192 px por lado.H3-Image-Context-IR— etapa de expansão de prompt, e não um endpoint de imagem, que reescreve um prompt curto e define uma proporção.
Estrutura pronta para copiar e colar, usando o host Global:
curl https://api.minimax.io/v1/images/generations \
-H "Authorization: Bearer $MINIMAX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"MiniMax-H3-Image","prompt":"...","size":"auto","aspect_ratio":"16:9","area":"2K","disable_prompt_enhanced":false,"response_format":"url"}'A documentação informa que as requisições não são idempotentes, que o servidor pode levar até 600 segundos e que a geração continua mesmo se o cliente expirar ou se desconectar. Uma imagem concluída continua sendo cobrada, e apenas imagens bem-sucedidas entram na cobrança (usage contabiliza os sucessos). A MiniMax recomenda max_retries=0 com o SDK da OpenAI. Em caso de sucesso parcial, a resposta é HTTP 200 com entradas data[].error por imagem, inclusive para falhas de segurança de conteúdo; portanto, inspecione cada item. Somente lotes em que todas as imagens falham retornam 4xx/5xx. Trate a maior parte dos 4xx como erros finais de configuração, nunca reenvie a requisição após timeouts ambíguos e, em provedores assíncronos, consulte o job existente em vez de enviar outro.
A melhoria de prompt vem ativada por padrão. Ela pode ser desativada em texto para imagem, mas não em edições, e a API devolve o prompt reescrito em data[].revised_prompt. Registre esse campo e compare-o com o prompt enviado antes de ajustar qualquer outra variável. Com o aprimorador desativado, há limitações: o modelo lê aproximadamente os primeiros 4,096 tokens, e você precisa informar um tamanho exato ou uma proporção explícita.
Hospedar localmente não significa gerar em 10 segundos: pesos, VRAM e licença
Os pesos estão disponíveis no Hugging Face MiniMaxAI/MiniMax-H3-Image e no GitHub MiniMax-AI/MiniMax-H3-Image, incluindo pesos convertidos para ComfyUI e o template de workflow image_minimax_h3_image_t2i.json. O card do modelo documenta um diffusion transformer de 33.1B de parâmetros, um checkpoint BF16 de 68.65 GB e um encoder de texto H3 separado, de 66.7 GB — cerca de 135 GB antes do expansor de prompt opcional de 17.9 GB. Para o servidor local, o card fixa 6 etapas de inferência com guidance scale 1; outros valores retornam HTTP 400. Também não há suporte a prompts negativos.
Não espere os mesmos 10 segundos em uma placa gamer. Discussões sobre ComfyUI questionam se o modelo cabe em uma 5090, mesmo com quantização de 4 bits. No tópico linkado sobre pesos abertos, um usuário de RTX 5090 relata cerca de 21 segundos para 16 MP em INT8, com resultado granulado, e diz precisar de BF16 para obter nitidez, com mais tempo de processamento. Já um usuário de RTX 3070 Ti, no tópico do ComfyUI, considera o T2I rápido para saídas de 16 MP, mas afirma que a edição por referência ignorou o prompt. É um único relato, não uma prova de que quantização agressiva seja segura para trabalho com referências.
Para muitas equipes, a licença pesa mais que a VRAM. O card do modelo usa a MiniMax-H3-Image Community License Agreement, datada de November 10, 2026: a concessão padrão exclui os Estados Unidos, a União Europeia, o Reino Unido e a República da Coreia; exige autorização prévia por escrito para receita anualizada acima de $1M ou para serviços hospedados destinados a terceiros; e exige que interfaces comerciais exibam "MiniMax-H3-Image". Equipes sediadas nos EUA ou na UE devem resolver o licenciamento antes de hospedar o modelo localmente.
Quanto custam imagens 1K, 2K e 4K: os exemplos da MiniMax
Todos os valores abaixo são custos de exemplo fornecidos pela MiniMax, não preços fixos. A cobrança é baseada em tokens, portanto o tamanho do prompt e a quantidade de referências alteram o total. Os exemplos assumem imagens de referência em 1K quando há referências.
| Tarefa | Exemplo Standard | Exemplo Highspeed |
|---|---|---|
| T2I, área 1K | $0.02179 | $0.03529 |
| T2I, área 2K | $0.02333 | $0.03622 |
| T2I, área 4K | $0.06879 ($0.03439 promo) | $0.13001 ($0.06501 promo) |
| Edição 4K + 1 ref | $0.07312 ($0.03656 promo) | $0.13673 ($0.06837 promo) |
| Edição 4K + 3 refs | $0.07914 ($0.03957 promo) | $0.15407 ($0.07703 promo) |
Há três pontos para economizar. Primeiro: 2K custa quase o mesmo que 1K ($0.02333 contra $0.02179), entregando 4x mais pixels-alvo. Quando ambas as opções servirem, prefira 2K. Segundo: 4K reúne 16x os pixels de 1K por cerca de 3.2x o preço de exemplo, então o 4K nativo é eficiente quando você precisa de detalhe para impressão. Terceiro: a promoção de lançamento reduz pela metade o 4K elegível para $0.03439 no Standard até November 17, 2026 at 16:00 UTC, para saídas com ao menos 16,600,000 pixels.
O Highspeed praticamente dobra as tarifas de tokens de imagem para economizar de 3–7 segundos. Em T2I 4K, são $0.13001 contra $0.06879, ou 1.89x. A menos que você esteja processando catálogos em lote sob um SLO de latência, o Standard é a escolha mais vantajosa. Cada referência adicional adiciona tokens de imagem de entrada: uma edição 4K com 3 referências custa cerca de 8% mais que uma com 1 referência, antes mesmo de considerar a qualidade.
Vale chamar essa API ou usar Qwen, Krea ou H3 video?
Para geração em lote de texto para imagem em alta resolução, o H3-Image é atraente pelos exemplos publicados de preço e latência da MiniMax. Se a prioridade é preservar identidade, teste as alternativas abaixo antes de se comprometer.
| Caso de uso | Escolha | Motivo |
|---|---|---|
| Cartazes, fundos e paisagens 4K em T2I em volume | H3-Image Standard | Exemplos de $0.023 em 2K e $0.069 em 4K; 4K mais rápido no gráfico da MiniMax |
| Lotes sensíveis à latência, como anúncios e previews ao vivo | H3-Image Highspeed | De 7.7s em 1K a 10.3s em 4K; pague 1.9x para economizar ~6s |
| Consistência de personagem ou produto com múltiplas referências | Qwen Image via Alibaba Cloud ou H3 video ref2i | Os tópicos linkados consideram o H3-Image mais fraco que o QI 2.1 em edições multi-ref; vários usuários mantêm o H3 video para ref2i |
| Interface gerenciada de edição em vez de API ou hospedagem local | Krea | Sem a necessidade de uma infraestrutura local de ~135 GB; é uma alternativa de interface, não equivalente a uma API |
| Hospedagem local com 24GB ou menos | Espere builds podadas/INT4 | Hoje, BF16 exige VRAM de nível datacenter |
Quando a semelhança é decisiva, qualquer economia no exemplo de preço por imagem desaparece nas tentativas extras.
Checklist para lançar sem imagens borradas e cobranças inesperadas
- Comece com presets 1K/2K e suba para 4K apenas nas imagens aprovadas; testadores relatam 4K padrão suave, então valide a nitidez em 2K primeiro.
- Registre
revised_promptem todas as execuções e compare-o com o prompt enviado antes de mudar qualquer outra configuração. - Configure timeouts do cliente acima de 600s, pois o servidor pode levar até 600s; desative novas tentativas automáticas do SDK, mantenha uma chave de deduplicação do lado do cliente apenas para reconciliação e, em provedores assíncronos, consulte o job em vez de reenviar a requisição.
- Trate as entradas
data[].errorde cada imagem em lotes multi-output com HTTP 200; consulte a referência de edições para conferir o envelope de erros antes de implementar o loop. - Confirme licença,
response_formate o download dos prompts: segundo a documentação da API, respostas emurlnão têm garantia de armazenamento durável.
Perguntas frequentes sobre a API MiniMax H3-Image
Qual é a diferença entre MiniMax H3-Image e MiniMax H3?
H3 é o modelo de vídeo; H3-Image é o modelo de imagens estáticas construído sobre ele, voltado a texto para imagem e edição em áreas de classe 4K. Para consistência de referência para imagem, vários usuários nos tópicos linkados ainda preferem o H3 video.
Qual é o endpoint oficial e o ID do modelo?
POST https://api.minimax.io/v1/images/generations com model: MiniMax-H3-Image ou MiniMax-H3-Image-Highspeed, além de /v1/images/edits e H3-Image-Context-IR para expansão de prompt.
Posso desativar a melhoria de prompt?
Em texto para imagem, sim, com disable_prompt_enhanced: true. Em edição, não. A API retorna o prompt reescrito que foi utilizado.
Posso executar o H3-Image localmente em uma GPU de consumidor?
Somente com quantização e paciência: são ~135 GB em BF16 antes do expansor de prompt. O card do modelo cita aceleradores da classe H200, RTX PRO 6000 e MI350X para as receitas de servidor.
Ele pode ser usado comercialmente?
Apenas após resolver os requisitos da MiniMax-H3-Image Community License: a concessão padrão exclui EUA, UE, Reino Unido e Coreia, além de exigir autorização para receita acima de $1M ou serviços hospedados para terceiros.