MiniMax H3 Image API: geração, edição e preços reais

Preços do mesmo modelo entre provedores: Cheap MiniMax H3 Image API · 2026-11-13

Recursos do MiniMax H3 Image e limites da API hospedada

O motivo mais forte para avaliar o H3 Image é seu fluxo unificado de geração e edição: descreva um novo asset, forneça referências de produto ou personagem e peça uma alteração direcionada. A MiniMax também publica pesos para implantação local. As alegações de capacidade publicadas não são garantia de preservação exata de logotipos, tipografia ou identidade em todas as saídas.

Recurso da API hospedada	Contrato documentado
Geração	POST /v1/images/generations
Edição	POST /v1/images/edits, 1–16 imagens de referência
Prompt	Até 32,000 caracteres; sem enhancement, apenas cerca dos primeiros 4,096 tokens têm efeito
Dimensões de saída	655,360–20,000,000 pixels; proporção de 1:3 a 3:1
Quantidade de saídas	n de 1 a 10
Formatos	JPEG por padrão; PNG ou WebP suportados
Respostas	URL ou Base64 sem streaming; SSE nativo suportado
Controles não suportados	Edição com máscara, fundos transparentes e imagens de pré-visualização

Os arquivos de referência precisam atender aos limites de entrada da MiniMax: JPG/JPEG, PNG, WebP, HEIC ou HEIF, cada dimensão entre 128 e 8,192 pixels, proporção entre o lado maior e o menor de no máximo 4:1 e corpo total da requisição de no máximo 64 MiB. Base64 aumenta o tamanho da requisição. Use URLs de imagem acessíveis ou uploads de tamanho adequado; a capacidade do modelo de aceitar 16 imagens não elimina o limite de tamanho do corpo.

“4K” é uma configuração de área nesta API. area: "4K" aponta para cerca de 4096 × 4096 pixels, com dimensões derivadas da proporção. Em 16:9, a saída documentada é 5472 × 3072, e não 4096 × 2304. Para dimensões explícitas, envie size: "WIDTHxHEIGHT" e omita area e aspect_ratio. Para dimensionamento por área, use size: "auto", area e aspect_ratio. Confira data[].size e as dimensões reais da imagem baixada.

Quanto custa o MiniMax H3 Image?

Para a rota Standard atual da APIMaster, o cálculo com tarifas regulares é:

USD = (text_input_tokens × 2.30
     + image_input_tokens × 1.50
     + image_output_tokens × 3.80) / 1,000,000

Use campos de uso separados para texto e imagem; não cobre todos os tokens de entrada como texto e depois adicione a entrada de imagem novamente. O enhancement de prompt contribui com tokens de texto cobrados, então a resolução sozinha não determina o preço total. Coeficientes específicos de conta, quando aplicáveis, e o arredondamento de cobrança podem afetar o débito final.

Os totais ilustrativos oficiais do Standard da MiniMax mostram a escala da fatura. Estes são exemplos, não tarifas fixas da APIMaster nem nossa média medida:

Tarefa	1K: 1024 × 1024	2K: 2048 × 2048	4K: 4096 × 4096, tarifa regular
Texto para imagem	$0.02179	$0.02333	$0.06879
Edição com uma referência 1K	$0.02654	$0.02658	$0.07312
Edição com três referências 1K	$0.03563	$0.04177	$0.07914

Para contexto, 1,000 requisições de texto para imagem no primeiro exemplo seriam aproximadamente $21.79; esse é um cálculo ilustrativo de orçamento de tokens, não um pacote pré-pago. Prompts e enhancement reais podem alterá-lo. O Nano Banana 2.1 tem um contrato diferente na APIMaster, baseado em resolução, a partir de $15.12 para 1,000 imagens 1K antes de quaisquer condições cotadas separadamente.

A promoção oficial de 50% para 4K vale na APIMaster?

Não presuma que sim. A MiniMax anuncia 50% de desconto no custo total da requisição para Standard e Highspeed até 17 de novembro de 2026, 16:00 UTC, exclusive — 18 de novembro às 00:00 no horário de Pequim — quando a imagem final entregue tiver pelo menos 16,600,000 pixels. Seu exemplo quadrado de texto para imagem em 4K passa de $0.06879 para $0.03439 durante essa oferta.

Uma saída de 4096 × 4096 se qualifica por área; 4096 × 2304 não. O rótulo “4K” sozinho é insuficiente. A rota pública atual da APIMaster usa as tarifas regulares por token, sem essa promoção temporária. Compare o contrato real de checkout/uso, não a manchete da campanha da MiniMax. Após o prazo, os exemplos promocionais não devem ser usados como preços atuais.

Exemplo de API do MiniMax H3 Image: texto para imagem

Crie uma conta na APIMaster, adicione saldo para requisições de imagem pagas e depois crie uma chave em chaves de API. Defina APIMASTER_API_KEY no seu ambiente. Este exemplo usa o ID de modelo exato e sensível a maiúsculas e minúsculas da rota Standard:

import os
import requests

base_url = "https://apimaster.ai/v1"
headers = {"Authorization": f"Bearer {os.environ['APIMASTER_API_KEY']}"}
response = requests.post(
    f"{base_url}/images/generations",
    headers=headers,
    json={
        "model": "MiniMax-H3-Image",
        "prompt": "A studio product photo of a matte blue teapot and two pears on a cream table, soft daylight, no text.",
        "size": "auto",
        "aspect_ratio": "16:9",
        "area": "2K",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
response.raise_for_status()
result = response.json()
for item in result.get("data", []):
    if item.get("error"):
        print("Image failed:", item["error"])
    else:
        print(item.get("url"), item.get("size"))
print("Usage:", result.get("usage"))

Este é um exemplo de requisição, não um benchmark de qualidade de imagem. Baixe prontamente as URLs de saída bem-sucedidas e armazene os arquivos você mesmo. Verifique erros por imagem: com n > 1, um HTTP 200 pode incluir imagens com falha. Um timeout não prova que a requisição foi rejeitada. A geração do H3 não é idempotente, então uma nova tentativa automática pode criar outra geração paga. Se usar o SDK da OpenAI, defina um timeout suficientemente longo e max_retries=0.

Edição com MiniMax H3 Image: imagens de referência e controle de prompt

Para edição via JSON, envie URLs de referência em images[].image_url. Não copie o campo image_urls do Nano Banana para esta requisição do H3. Substitua as URLs de exemplo por seus próprios assets acessíveis:

edit = requests.post(
    f"{base_url}/images/edits",
    headers=headers,
    json={
        "model": "MiniMax-H3-Image",
        "prompt": "Keep the product shape and label from image 1. Use the background palette from image 2. Do not add text or change the product.",
        "images": [
            {"image_url": "https://example.com/product.png"},
            {"image_url": "https://example.com/palette.png"},
        ],
        "size": "2048x2048",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
edit.raise_for_status()
print(edit.json())

Os testes de aceitação da integração da APIMaster de 11 de novembro cobriram referências HTTP, data URIs, uploads multipart, edição com múltiplas referências, SSE e saídas decodificadas em 1K/2K/4K. Um teste controlado com duas referências manteve quatro formas coloridas e dois rótulos curtos. Essas foram verificações de interface e cobrança com assets simples, não uma avaliação fotográfica ou tipográfica ampla; elas não estabelecem superioridade sobre outro modelo.

A geração usa enhancement de prompt por padrão; você pode desativá-lo com disable_prompt_enhanced: true ao fornecer dimensões fixas ou uma proporção fixa. As edições sempre usam enhancement. Inspecione revised_prompt ao diagnosticar alterações inesperadas. Para trabalhos com produto, especifique o que deve permanecer fixo, identifique o papel de cada referência e verifique o rótulo renderizado antes de publicá-lo.

Standard vs Highspeed, e pesos abertos vs API hospedada

O Highspeed usa os mesmos parâmetros de API documentados, mas suas tarifas oficiais de entrada de imagem e saída de imagem são o dobro das do Standard; a entrada de texto permanece em $2.30/M. A APIMaster atualmente lista apenas o Standard. As alegações de velocidade de lançamento da MiniMax dependem da variante do modelo, do tamanho e da implantação e não são uma garantia de latência medida na APIMaster.

O repositório oficial no Hugging Face fornece pesos e integrações incluindo Diffusers, SGLang, vLLM-Omni e ComfyUI. Seu checkpoint BF16 tem cerca de 68.65 GB, com um text encoder separado de aproximadamente 66.7 GB. O tamanho do download não é uma estimativa completa de memória de GPU. Os pesos locais usam a licença comunitária do MiniMax H3 Image, então revise essa licença antes da implantação; “pesos abertos” não significa uso irrestrito sob MIT ou Apache.

Use o acesso hospedado para avaliar prompts sem construir infraestrutura de inferência. Considere a implantação local quando o controle sobre a inferência justificar o trabalho de GPU, manutenção e licenciamento. Os limites do pipeline local e os limites da API hospedada são contratos diferentes.

FAQ

O MiniMax H3 Image é o mesmo que o vídeo MiniMax H3?

Não. O H3 Image gera e edita imagens estáticas usando MiniMax-H3-Image. A família de vídeo H3 tem IDs de modelo, endpoints e cobrança diferentes. Veja o guia separado do vídeo MiniMax H3.

O MiniMax H3 Image está disponível na APIMaster?

Sim. A verificação de 13 de novembro encontrou uma rota pública Standard habilitada, cobrada a $2.30/M de entrada de texto, $1.50/M de entrada de imagem e $3.80/M de saída de imagem. O Highspeed não tinha rota pública. Confira o card ao vivo do modelo antes de enviar requisições.

O H3 Image é uma API de preço fixo de $0.02 por imagem?

Não. Os exemplos oficiais por imagem são totais ilustrativos. O uso real de tokens, o enhancement de prompt, as entradas de referência e as dimensões de saída determinam a fatura. A rota atual da APIMaster usa a fórmula regular de tokens.

O H3 Image consegue editar com 16 referências ou uma máscara?

Ele documenta até 16 imagens de referência dentro dos limites de formato e de tamanho da requisição. Edição com máscara e fundos transparentes não são suportados. Instruções baseadas em referência não garantem preservação pixel a pixel.

Qual é mais barato: H3 Image ou Nano Banana 2.1?

Para a tarefa ilustrada de texto para imagem em 1K, o exemplo oficial regular do H3 é $0.02179, contra o Nano Banana 2.1 da APIMaster a partir de $0.01512 por imagem 1K. Isso compara um total de tokens de exemplo com uma cotação por resolução; meça o custo real por saída aceita para os seus prompts. Veja a comparação dedicada.

Fontes e próximos passos

Fontes verificadas em 13 de novembro de 2026: lançamento da MiniMax, guia da API hospedada, preços e promoção oficiais, pesos e licença do modelo, preços de imagem da Google e cards ao vivo do mercado da APIMaster. As descrições de capacidade vêm dos respectivos fornecedores; as verificações de preço e as observações datadas da integração da APIMaster são identificadas separadamente.

Abra o card do H3 Image, registre-se, crie uma chave de API e envie MiniMax-H3-Image para https://apimaster.ai/v1. Para uma alternativa com desconto e um contrato de cobrança diferente, compare as rotas do Nano Banana 2.1, atualmente até 55% abaixo da referência de saída de imagem da Google.