O que é o MiniMax H3-Image?

O MiniMax H3-Image é um modelo de imagem com pesos abertos da MiniMax, lançado em 10 de novembro de 2026, que gera e edita imagens com cerca de 16 megapixels (4096 x 4096) sem precisar de um upscaler. Segundo a MiniMax, uma imagem 4K leva cerca de 10 segundos. Você pode chamá-lo pela API da MiniMax, usá-lo no Hailuo AI e no MiniMax Code, ou baixar os pesos no Hugging Face.

Este guia explica o que é o MiniMax H3-Image, o que a MiniMax realmente alega, o que significa “pesos abertos” sob a sua licença, quanto custa durante o desconto da semana de lançamento e como testar a API a partir do seu agente de código.

O que é o MiniMax H3-Image?

O MiniMax H3-Image é um modelo de texto-para-imagem e edição de imagens da família H3 da MiniMax. Um único checkpoint cuida das duas tarefas: ele cria imagens a partir de um prompt e edita até 16 imagens de referência. Ele gera cerca de 16 megapixels em qualquer proporção, de 4096 x 4096 (1:1) a 6272 x 2688 (21:9), e seus pesos são publicados sob uma licença comunitária.

No post de lançamento no X, a MiniMax resume a proposta: “geração de imagens 4K em 10 segundos”, 16 milhões de pixels, realismo, precisão no seguimento de prompts e nas edições, até 16 imagens de referência e pesos abertos.

O H3-Image é separado do modelo de código da MiniMax, abordado no explicativo sobre o MiniMax M3, e tem seus próprios endpoints de API.

O que a MiniMax afirma sobre o H3-Image

Veja o que a MiniMax publica no model card do Hugging Face e no anúncio. Trate as afirmações de velocidade e qualidade como alegações da MiniMax; nenhuma medição independente havia sido publicada por terceiros quando este texto foi escrito.

Afirmação	O que a MiniMax diz	Onde
Resolução	Cerca de 16 MP, 4096 x 4096 em 1:1, até 6272 x 2688 em 21:9, sem upscaler	Model card
Velocidade	Uma imagem 4K em cerca de 10 segundos	Post de lançamento
Amostragem	Destilado para 6 etapas de amostragem, sem classifier-free guidance	Model card
Referências	Até 16 imagens de referência por edição	Model card, guia da API
Seguimento de instruções	“O melhor seguimento de instruções entre os modelos open-source”	Model card
Faixa de trabalho	Cerca de 4 MP a 20 MP, melhores resultados em torno de 16 MP	Model card

A alegação de velocidade se apoia em 6 etapas destiladas e na ausência de classifier-free guidance, que normalmente dobra o trabalho por etapa. A MiniMax não informa o hardware por trás do número de 10 segundos, então não o leia como uma promessa para a sua própria GPU.

O model card não apresenta nenhuma tabela de benchmarks para respaldar a afirmação sobre seguimento de instruções. Nosso post irmão, MiniMax H3-Image vs Nano Banana 2.1, coloca os dois lado a lado.

O que há dentro do modelo

O model card é incomumente específico sobre a arquitetura:

Transformer de difusão: 33,1B de parâmetros, um transformer denso de fluxo único com 50 camadas, armazenado em BF16 (68,65 GB).
Codificador de texto: o text encoder do MiniMax-H3, sem alterações, carregado do repositório separado do MiniMax-H3 (66,7 GB).
VAE de imagem: downsampling espacial de 16x e 24 canais latentes (2,34 GB).
Expansor de prompt opcional: MiniMax-H3-Image-PE (17,9 GB, NVFP4), que transforma um prompt curto na descrição detalhada em inglês que o modelo espera.

Somando tudo, uma configuração local completa baixa cerca de 137 GB antes do expansor opcional.

O que significa “pesos abertos” para o MiniMax H3-Image

O MiniMax H3-Image tem pesos abertos, mas não é open-source no sentido da OSI. Você pode baixar e executar os pesos, mas a MiniMax-H3-Image Community License impõe limites reais. Leia-a antes de construir algo sobre o modelo. Os pontos que afetam a maioria das equipes:

Território. A licença concede direitos em todo o mundo, exceto nos “Territórios Excluídos”: União Europeia, Reino Unido, Coreia do Sul e Estados Unidos. Equipes nessas regiões precisam entrar em contato com a MiniMax para uma licença separada.
Receita e hospedagem. Você precisa de autorização prévia por escrito da MiniMax se você e suas afiliadas faturarem mais de US$ 1 milhão em receita anualizada, ou se você oferecer o modelo como serviço hospedado a terceiros. As solicitações passam pelo console de licenças da MiniMax.
Atribuição. Produtos comerciais devem exibir “MiniMax-H3-Image” de forma proeminente na interface do usuário.
Sem treinamento de outros modelos. Você não pode usar o modelo ou seus resultados para melhorar qualquer outro modelo de IA.
Divulgação. A política de uso aceitável proíbe publicar conteúdo gerado publicamente sem divulgar claramente que foi criado por máquina.

A MiniMax não reivindica direitos sobre as imagens que você gera. Se você usa apenas a API hospedada, leia também os termos da plataforma da MiniMax para esse uso.

Onde você pode usar o MiniMax H3-Image

Diagrama das quatro formas de acessar o MiniMax H3-Image: os endpoints da API da MiniMax, o aplicativo web Hailuo AI, o aplicativo desktop MiniMax Code e os pesos abertos no Hugging Face para auto-hospedagem

Você tem quatro caminhos:

API da MiniMax. Texto-para-imagem em POST https://api.minimax.io/v1/images/generations e edição em /v1/images/edits, ambos com o ID de modelo MiniMax-H3-Image ou o mais rápido MiniMax-H3-Image-Highspeed. O passo a passo completo está em nosso guia da API do MiniMax H3-Image.
Hailuo AI. O aplicativo web da MiniMax, sem necessidade de código.
MiniMax Code. O aplicativo desktop da MiniMax para macOS e Windows, citado no post de lançamento como um lugar para usar o H3-Image.
Auto-hospedagem. A MiniMax recomenda SGLang, vLLM-Omni, diffusers ou ComfyUI, e lista NVIDIA H200, RTX PRO 6000 Blackwell e AMD Instinct MI350X entre os aceleradores suportados. O model card não indica um valor mínimo de VRAM.

Se você procura caminhos sem custo, o post MiniMax H3-Image de graça cobre essas opções.

Como funciona a API do MiniMax H3-Image

A API segue um formato de imagens no estilo OpenAI, então a requisição é curta:

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": "An orange cat on a sunny windowsill, film texture",
    "aspect_ratio": "16:9",
    "area": "4K",
    "response_format": "url"
  }'

Os parâmetros que valem a pena conhecer, conforme a referência da API:

size aceita WIDTHxHEIGHT (655.360 a 20.000.000 pixels, proporção entre 1:3 e 3:1) ou auto. Com auto, você define aspect_ratio e area (1K, 2K ou 4K, padrão 4K) em vez disso. Misturar as duas formas retorna um erro 400.
n solicita de 1 a 10 imagens por requisição.
output_format é jpeg por padrão, ou png ou webp.
response_format é url (baixe você mesmo, pois não há garantia de que a URL permanecerá disponível) ou b64_json.
stream: true envia cada imagem via server-sent events assim que fica pronta.
O aprimoramento de prompt está ativado por padrão. Cada resultado traz um revised_prompt mostrando o que o modelo realmente usou. Defina disable_prompt_enhanced: true para enviar seu prompt como está.

Um comportamento pega muita gente de surpresa: se pelo menos uma imagem é gerada com sucesso, a chamada retorna HTTP 200 mesmo quando outras falham na verificação de segurança de conteúdo. Verifique data[].error em cada item. Apenas as imagens bem-sucedidas são cobradas.

O guia também lista o que não é suportado: imagens de pré-visualização, edições com máscara e fundos transparentes.

Para edição, você envia de 1 a 16 imagens de referência como URLs públicas, IDs de arquivos enviados ou data URIs, com até 64 MiB no total por requisição. Seu prompt se refere a elas como <Picture 1>, <Picture 2> e assim por diante, na ordem de envio.

Preços do MiniMax H3-Image e o desconto da semana de lançamento

A MiniMax cobra o H3-Image por milhão de tokens, dividido em entrada de texto, entrada de imagem e saída de imagem. Conforme a página de preços da MiniMax, consultada em 11 de novembro de 2026:

Modelo	Texto de entrada / M tokens	Imagem de entrada / M tokens	Imagem de saída / M tokens
MiniMax-H3-Image	$2,30	$1,50	$3,80
MiniMax-H3-Image-Highspeed	$2,30	$3,00	$7,60

Os custos de exemplo da própria MiniMax por resultado de texto-para-imagem no modelo padrão são US$ 0,02179 em 1K, US$ 0,02333 em 2K e US$ 0,06879 em 4K. O exemplo 4K do Highspeed custa US$ 0,13001.

O desconto de lançamento é de 50% no custo total da requisição em ambos os modelos quando a imagem entregue tem pelo menos 16.600.000 pixels. Ele vale até 17 de novembro de 2026, às 16:00 UTC. Durante esse período, a MiniMax lista um resultado padrão de texto-para-imagem 4K a US$ 0,03439 e um do Highspeed a US$ 0,06501. Imagens menores não se qualificam, então uma renderização 2K custa o mesmo de antes.

Teste a API do MiniMax H3-Image com o Apidog CLI

Antes de integrar o H3-Image em um aplicativo, confirme que o formato da sua requisição, a autenticação e o tratamento de erros funcionam, incluindo o caso “200 com um item com falha”. Deixe seu agente de código construir e executar essa verificação com o Apidog CLI em vez de clicar manualmente nas requisições.

Diagrama de fluxo de trabalho: um agente de código usa o Apidog CLI para criar um endpoint e um caso de teste, chama POST /v1/images/generations no MiniMax H3-Image, lê um relatório de teste verificando status 200, data[0].url e ausência de data[].error, e então corrige e executa novamente

Configure o CLI uma única vez:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_APIDOG_TOKEN>
apidog skill install

A skill ensina ao seu agente (Claude Code, Codex, Cursor ou outro) os comandos do CLI. Em seguida, dê a ele um único prompt:

In Apidog project <projectId>, add the MiniMax H3-Image endpoint
POST /v1/images/generations from https://platform.minimax.io/docs/api-reference/image-generation-h3-generations
with Bearer auth from {{MINIMAX_API_KEY}}. Create an environment with base URL
https://api.minimax.io. Write a test case that sends model MiniMax-H3-Image,
area 1K, n 1, and asserts status 200, data[0].url exists, data[0].error is absent
and usage.generated_images equals 1. Run it and summarize the result.

O agente transforma isso em uma pequena sequência de comandos apidog. Cada flag abaixo vem de apidog <command> --help no Apidog CLI 2.2.12:

apidog environment create --project <projectId> --base-url https://api.minimax.io
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file ./h3-endpoint.json
apidog endpoint create --project <projectId> --file ./h3-endpoint.json
apidog test-case category --project <projectId>
apidog cli-schema validate test-case-create --file ./h3-case.json
apidog test-case create --project <projectId> --file ./h3-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> \
  --env-var "MINIMAX_API_KEY=$MINIMAX_API_KEY" -r cli,json

O cli-schema get entrega ao agente o formato JSON exato, e o cli-schema validate verifica cada arquivo antes que algo seja gravado. O test-case category fornece um ID de categoria válido para que o caso apareça no aplicativo. A execução imprime um resumo de aprovação ou falha no seu terminal e grava um relatório JSON que o agente lê para decidir o que corrigir. Adicione --upload-report para visualizar a mesma execução no Apidog.

Usar area: 1K mantém cada chamada de teste no menor preço de exemplo listado pela MiniMax. Para saber mais sobre esse padrão, veja o fluxo de trabalho do agente com Apidog CLI e o Apidog CLI no Claude Code. O plano Free do Apidog cobre até 4 usuários.

Vale a pena experimentar o MiniMax H3-Image?

Experimente se você precisa de imagens grandes e detalhadas e quer uma opção de pesos abertos, ou se a edição com múltiplas referências (fotos de produtos, layouts de ambientes, folhas de personagem) é o seu caso de uso. O desconto de lançamento torna os testes em 4K baratos até 17 de novembro.

Pense duas vezes antes de auto-hospedar: cerca de 137 GB de pesos, GPUs de data center e uma licença que exclui UE, Reino Unido, Coreia do Sul e EUA. Para a maioria das equipes, a API é o caminho prático. Se você está comparando APIs de imagem, nossos guias sobre a API do GPT Image 2.6, a API do Nano Banana 2.1 e o Qwen-Image 2.1 cobrem as alternativas.

Perguntas frequentes

O MiniMax H3-Image é gratuito? Os pesos podem ser baixados e executados sem royalties dentro do território permitido pela licença, respeitando seus limites de receita e hospedagem. A API é paga por token. Veja nosso guia de acesso gratuito para opções sem custo.

O MiniMax H3-Image é open-source? A MiniMax o chama de open-source no Hugging Face, mas ele é distribuído sob uma licença comunitária personalizada, com restrições de território, receita, atribuição e proibição de treinamento. “Pesos abertos” é o termo mais preciso.

Quão rápido é o MiniMax H3-Image? A MiniMax diz que uma imagem 4K leva cerca de 10 segundos. Esse é o número da empresa; ela não informa o hardware, e não existia benchmark independente quando este texto foi escrito.

Qual é a diferença entre MiniMax-H3-Image e MiniMax-H3-Image-Highspeed? Ambos aceitam os mesmos parâmetros e limites. O Highspeed é a camada mais rápida e custa mais: US$ 7,60 por milhão de tokens de imagem de saída, contra US$ 3,80.

Quantas imagens de referência o MiniMax H3-Image aceita? Até 16 por requisição de edição, cada uma com 128 a 8.192 pixels por lado, com o corpo inteiro da requisição limitado a 64 MiB.

Quando termina o desconto de lançamento do MiniMax H3-Image? Em 17 de novembro de 2026, às 16:00 UTC. Ele se aplica apenas a imagens de pelo menos 16.600.000 pixels.