MiniMax H3 Image API
O modelo de imagem de pesos abertos da MiniMax: 4K nativo de até 17 megapixels e edição com até 16 imagens de referência
- 1K
- KIE $ 0,0115 / imagem
- Oficial
≈$ 0,031263%–72% mais barato - 2K
- KIE $ 0,0115 / imagem
- Oficial
≈$ 0,032865%–72% mais barato - 4K
- KIE $ 0,03 / imagem
- Oficial
≈$ 0,078262%–69% mais barato
Preços da API MiniMax H3 Image por imagem
A KIE cobra um preço fixo por nível, cerca de 40% do preço de tabela da MiniMax, mais $0.0025 por imagem de referência. O preço oficial é uma estimativa por tokens e não inclui os 50% de desconto em 4K da semana de lançamento
Roteamento automático e failover
Chame o MiniMax H3 Image com um único ID de modelo e a Yir escolhe o canal de cada job entre MiniMax e KIE: ele vai para o canal elegível com o menor preço estimado e é cobrado pelo preço público desse canal, sem markup. Se uma tentativa falhar, a Yir tenta de novo em outro canal sem passar do seu max_cost. Não é preciso parâmetro de roteamento na solicitação. Documentação de roteamento e failover
Notas de preço
Cobrado pelo canal que de fato executa o job. O failover pode trocar de canal, o que pode mudar o custo e o tempo.
4K nativo, com os pesos abertos
Pesos abertos que cabem numa placa de 16 GB
Os pesos estão no Hugging Face; um usuário gerou imagens de 16 MP numa única RTX 5080 de 16 GB, carregando o resto da memória do sistema
Nota mais alta em texto e design
Um teste independente com 600 prompts a 16 MP teve média de 3,94 de 5 com um avaliador de IA
- Texto e design
- 4.36
- Pessoas
- 4.22
- Comercial
- 3.56
- Infografia
- 3.56
Exemplos de geração
Todas as imagens aqui foram geradas pelo MiniMax H3 Image. Abra uma para testar o prompt original no playground
Recortada a 100%, continua firme
Cada quadro é um recorte 1:1 de um original 4K acima, cerca de 7% da imagem

Rótulos de especiarias escritos à mão

Mãos calejadas na rede

Gotas de orvalho na teia

Na escada da biblioteca
Usar a API
Deixe o código com um agente, gere direto no chat com MCP ou a Skill, ou integre você mesmo com o SDK ou a API compatível com OpenAI.
Deixe um agente de código fazer a integração
Copie o prompt de integração ou abra direto no Codex ou no Claude. O agente lê esta página e o contrato do modelo e depois escreve o envio, a espera e o tratamento do resultado no seu projeto.
Adicione o servidor MCP da Yir
Conecte ao ChatGPT, Claude ou Cursor, mencione @Yir e peça o MiniMax H3 Image pelo nome. Ele mostra o preço primeiro e só gera depois que você confirmar.
https://gateway.yir.ai/mcpUm comando para o Claude Code
Crie uma API key no console, defina como YIR_API_KEY e execute:
claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"Instale a Yir Skill
Defina YIR_API_KEY onde seu agente roda, adicione a Skill ao Claude Code, Codex ou outro agente de código e diga “use o MiniMax H3 Image na Yir para criar…”.
npx skills add yir-ai/skillsInstale o SDK oficial com seu gerenciador de pacotes ou copie o snippet abaixo para começar
| import { createNodeYirClient } from "@yir-ai/sdk/server"; |
| // Lê YIR_API_KEY do ambiente por padrão: process.env.YIR_API_KEY |
| const client = createNodeYirClient(); |
| // 1. Envia um job de geração de imagem |
| const job = await client.submitImage({ |
| model: "minimax/minimax-h3-image", |
| input: { |
| type: "text", |
| prompt: "Crie um pôster de produto de água com gás cítrica: uma garrafa de vidro transparente e laranjas frescas, fundo creme, luz natural suave e um rótulo de produto nítido", |
| }, |
| parameters: { |
| resolution: "4K", |
| aspect_ratio: "1:1", |
| n: 1, |
| }, |
| }); |
| // 2. Aguarda o job terminar e entregar o resultado |
| const result = await client.waitForJob(job.id); |
| console.log("Arquivos entregues:", result.result); |
| if (result.result && "files" in result.result) { |
| for (const file of result.result.files) { |
| console.log("->", file.url); |
| } |
| } |
Projetos que já usam o protocolo da OpenAI, ou gateways como o new-api, só precisam de uma nova Base URL e key. Guia de compatibilidade com OpenAI
- base_url do SDK da OpenAI
https://gateway.yir.ai/openai/v1- Base URL do canal no new-api
https://gateway.yir.ai/openai- Key
- API Key do Yir
- ID do modelo
minimax/minimax-h3-image
curl https://gateway.yir.ai/openai/v1/images/generations \
-H "Authorization: Bearer $YIR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax/minimax-h3-image",
"prompt": "Crie um pôster de produto de água com gás cítrica: uma garrafa de vidro transparente e laranjas frescas, fundo creme, luz natural suave e um rótulo de produto nítido",
"resolution": "4K",
"aspect_ratio": "1:1"
}'Visão geral dos parâmetros
Parâmetros comuns; os limites dependem do modelo atual e do canal selecionado
- Resolução resolution
- 1K
- 2K
- 4K
Faixa de resolução da saída. Resoluções maiores dão mais nitidez e o preço acompanha
- Proporção aspect_ratio
- 1:1
- 2:3
- 3:2
- 3:4
- 4:3
- 4:5
- 5:4
- 9:16
- 16:9
- 21:9
Proporção geométrica. Escolha de acordo com o meio de destino (retrato, banner ou quadrado)
- Modo de entrada input_mode
- Entrada de texto
- Entrada de imagem
Os limites e formatos de referência dependem do modelo e do canal selecionado
- Referências references
- reference_image ≤ 16
Os limites por modo dependem do canal escolhido. As quantidades na tabela são exemplos de preço, não limites nem cotas gratuitas.





