# MiniMax H3 Image

> 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

- Página do modelo: https://yir.ai/pt/models/minimax-h3-image
- ID do modelo: `minimax/minimax-h3-image`
- Cobrança: pelo canal que executou o job; tentativas que o upstream não cobrou são grátis.

## 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

## Preços

Preços públicos atuais por canal para a mesma especificação de saída; os preços oficiais são uma referência. Você paga pelo canal que de fato executa o job, que pode mudar em um failover.

| Especificação de saída | Canal | Preço público |
|---|---|---|
| 1K | MiniMax (oficial) (Entrada de texto) | ≈$ 0,0218 / imagem |
| 1K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,0312 / imagem |
| 1K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,0406 / imagem |
| 1K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,0501 / imagem |
| 1K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,0595 / imagem |
| 1K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,0689 / imagem |
| 1K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,0783 / imagem |
| 1K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,0877 / imagem |
| 1K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,0972 / imagem |
| 1K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1066 / imagem |
| 1K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,116 / imagem |
| 1K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1254 / imagem |
| 1K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1348 / imagem |
| 1K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1443 / imagem |
| 1K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1537 / imagem |
| 1K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1631 / imagem |
| 1K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1725 / imagem |
| 1K | KIE | $ 0,009 ~ $ 0,0115 / imagem |
| 2K | MiniMax (oficial) (Entrada de texto) | ≈$ 0,0233 / imagem |
| 2K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,0328 / imagem |
| 2K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,0422 / imagem |
| 2K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,0516 / imagem |
| 2K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,061 / imagem |
| 2K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,0704 / imagem |
| 2K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,0799 / imagem |
| 2K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,0893 / imagem |
| 2K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,0987 / imagem |
| 2K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1081 / imagem |
| 2K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1175 / imagem |
| 2K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,127 / imagem |
| 2K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1364 / imagem |
| 2K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1458 / imagem |
| 2K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1552 / imagem |
| 2K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1646 / imagem |
| 2K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1741 / imagem |
| 2K | KIE | $ 0,009 ~ $ 0,0115 / imagem |
| 4K | MiniMax (oficial) (Entrada de texto) | ≈$ 0,0688 / imagem |
| 4K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,0782 / imagem |
| 4K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,0876 / imagem |
| 4K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,0971 / imagem |
| 4K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1065 / imagem |
| 4K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1159 / imagem |
| 4K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1253 / imagem |
| 4K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1347 / imagem |
| 4K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1442 / imagem |
| 4K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1536 / imagem |
| 4K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,163 / imagem |
| 4K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1724 / imagem |
| 4K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1818 / imagem |
| 4K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,1913 / imagem |
| 4K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,2007 / imagem |
| 4K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,2101 / imagem |
| 4K | MiniMax (oficial) (Entrada de imagem) | ≈$ 0,2195 / imagem |
| 4K | KIE | $ 0,0275 ~ $ 0,03 / imagem |

## Parâmetros

- Operação: `generate_image`

| Parâmetro | Valores | Padrão |
|---|---|---|
| `input` | text / image | text |
| `resolution` | 1K / 2K / 4K | 4K |
| `aspect_ratio` | 1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9 | 1:1 |

## Integração

Escolha uma opção: o SDK oficial para código novo, ou troque a Base URL em projetos que já usam o protocolo da OpenAI.

### SDK oficial (TypeScript)

O SDK chama a Standard API (https://gateway.yir.ai) para enviar, aguardar e coletar jobs; também há um SDK em Go. https://yir.ai/docs/integrations/sdk

```bash
pnpm add @yir-ai/sdk
```

```ts
import { createNodeYirClient } from "@yir-ai/sdk/server";

// Reads YIR_API_KEY from the environment by default: process.env.YIR_API_KEY
const client = createNodeYirClient();

// 1. Submit an image generation job
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. Wait for the job to finish and deliver its result
const result = await client.waitForJob(job.id);
console.log("Delivered files:", result.result);
if (result.result && "files" in result.result) {
  for (const file of result.result.files) {
    console.log("->", file.url);
  }
}
```

### API compatível com OpenAI

Protocolos OpenAI Images e Sora Videos para SDKs da OpenAI e gateways como o new-api; sem chat. https://yir.ai/docs/integrations/openai-compatibility

- base_url do SDK da OpenAI: `https://gateway.yir.ai/openai/v1`
- Base URL do canal no new-api (tipo de canal OpenAI): `https://gateway.yir.ai/openai`
- ID do modelo: `minimax/minimax-h3-image`

```bash
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"
  }'
```

## FAQ

### MiniMax H3 Image tem uma API oficial?

Sim. MiniMax vende MiniMax H3 Image pela própria API oficial, e o preço de tabela aparece como referência oficial na tabela acima. Com a Yir, você chama MiniMax H3 Image com uma única chave de API e compara com o preço público de cada provedor.

### MiniMax H3 Image ou Nano Banana 2.1: qual usar?

Use o MiniMax H3 Image se quiser pesos abertos para hospedar ou ajustar no futuro. Use o Nano Banana 2.1 se o preço vem primeiro: o canal 4K mais barato dele na Yir custa menos que o do H3 Image, e há mais provedores de failover.

### Quantos pixels tem uma imagem 4K do MiniMax H3 Image?

Cerca de 16 a 17 megapixels. Na KIE, o 4K é 4096 × 4096 em 1:1, 5472 × 3072 em 16:9 e 6272 × 2688 em 21:9; a rota oficial chega a 5440 × 3072 em 16:9.

### Qual a velocidade do MiniMax H3 Image em 4K?

A MiniMax diz que uma imagem 4K leva menos de 10 segundos na própria plataforma. No nosso teste com seis imagens 4K a partir de texto na KIE, o processamento levou de 23 a 39 segundos, com mediana de cerca de 28 (novembro de 2026).

### O MiniMax H3 Image consegue escrever texto nas imagens?

Sim. No mapa de trilhas desta página, o título, os nomes e a legenda saíram exatamente como escritos, embora o modelo tenha acrescentado uma linha "EST. 1925" que não pedimos. Coloque o texto exato entre aspas e diga onde ele fica.

### O MiniMax H3 Image é open source?

Os pesos são públicos no Hugging Face como MiniMaxAI/MiniMax-H3-Image, então no futuro você pode hospedar ou ajustar o modelo. Pela Yir você chama a API oficial da MiniMax ou a KIE, sem implantar nada.

## Regras

- Autentique com Authorization: Bearer $YIR_API_KEY; mantenha a key em uma variável de ambiente do servidor, nunca em código de navegador, controle de versão, prompts ou logs.
- Os jobs são assíncronos: guarde o Job ID, espere um estado final e depois leia o resultado; trate falhas e cancelamentos.
- Para retentativas seguras, reutilize a mesma chave de idempotência e a mesma requisição; não reenvie às cegas quando o resultado for desconhecido.
- As URLs de resultado são temporárias; copie os arquivos para outro lugar se precisar guardá-los.

## Links

- [Início rápido](https://yir.ai/docs/getting-started/quickstart)
- [Referência da API](https://yir.ai/docs/reference)
- [llms.txt](https://yir.ai/llms.txt)