Preço de lançamento (até 25 de dez.), garantido enquanto você continuar assinando: Go por $10/mês (de $20), Plus com Opus 5.5 por apenas $30/mês (de $50)Assinar agora →

API MiniMax H3-Image: custo em 4K, limites e VRAM (2026)

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.

ItemMiniMax-H3-Image (Standard)MiniMax-H3-Image-Highspeed
ObjetivoMenor custo por imagemMenor 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):

  1. POST https://api.minimax.io/v1/images/generations — texto para imagem; os parâmetros verificados incluem model, prompt (máximo de 32.000 caracteres), disable_prompt_enhanced (padrão false), n (1–10), size (auto ou WIDTHxHEIGHT), aspect_ratio, area (1K/2K/4K, padrão 4K), output_format (padrão jpeg), response_format (url/b64_json), stream, output_compression.
  2. POST /v1/images/edits — edição com 1–16 referências; aceita JPG/PNG/WebP/HEIC/HEIF, com 128–8192 px por lado.
  3. 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:

bash
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.

TarefaExemplo StandardExemplo 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 usoEscolhaMotivo
Cartazes, fundos e paisagens 4K em T2I em volumeH3-Image StandardExemplos 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 vivoH3-Image HighspeedDe 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ênciasQwen Image via Alibaba Cloud ou H3 video ref2iOs 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 localKreaSem a necessidade de uma infraestrutura local de ~135 GB; é uma alternativa de interface, não equivalente a uma API
Hospedagem local com 24GB ou menosEspere builds podadas/INT4Hoje, 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_prompt em 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[].error de 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_format e o download dos prompts: segundo a documentação da API, respostas em url nã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.