# MiniMax H3 Image

> El modelo de imagen de pesos abiertos de MiniMax: 4K nativo de hasta 17 megapíxeles y edición con hasta 16 imágenes de referencia

- Página del modelo: https://yir.ai/es/models/minimax-h3-image
- ID del modelo: `minimax/minimax-h3-image`
- Cobro: según el proveedor que ejecutó la tarea; los intentos que el proveedor no facturó son gratis.

## 4K nativo, con los pesos a la vista

### Pesos abiertos que caben en una tarjeta de 16 GB

Los pesos están en Hugging Face; un usuario generó imágenes de 16 MP con una sola RTX 5080 de 16 GB, cargando el resto desde la memoria del sistema

### La mejor nota, en texto y diseño

Una prueba independiente de 600 prompts a 16 MP obtuvo una media de 3,94 sobre 5 con un evaluador de IA

- Texto y diseño: 4.36
- Personas: 4.22
- Comercial: 3.56
- Infografía: 3.56

## Precios

Precios públicos actuales por proveedor para la misma especificación de salida; los precios oficiales son una referencia. Se te cobra según el proveedor que realmente ejecuta la tarea, que puede cambiar con un failover.

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

## Parámetros

- Operación: `generate_image`

| Parámetro | Valores | Por defecto |
|---|---|---|
| `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 |

## Integración

Elige una opción: el SDK oficial para código nuevo, o cambia la Base URL en proyectos que ya usan el protocolo de OpenAI.

### SDK oficial (TypeScript)

El SDK llama a la Standard API (https://gateway.yir.ai) para enviar tareas, esperarlas y recoger los resultados; también hay un SDK de 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: "Crea un póster de producto de agua con gas de cítricos: una botella de vidrio transparente y naranjas frescas, fondo crema, luz natural suave y una etiqueta de producto nítida",
  },
  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 compatible con OpenAI

Protocolos OpenAI Images y Sora Videos para los SDK de OpenAI y gateways como new-api; sin chat. https://yir.ai/docs/integrations/openai-compatibility

- base_url del SDK de OpenAI: `https://gateway.yir.ai/openai/v1`
- Base URL del canal en new-api (tipo de canal OpenAI): `https://gateway.yir.ai/openai`
- ID del 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": "Crea un póster de producto de agua con gas de cítricos: una botella de vidrio transparente y naranjas frescas, fondo crema, luz natural suave y una etiqueta de producto nítida",
    "resolution": "4K",
    "aspect_ratio": "1:1"
  }'
```

## Preguntas frecuentes

### ¿MiniMax H3 Image tiene una API oficial?

Sí. MiniMax vende MiniMax H3 Image a través de su propia API oficial, y su precio de lista aparece como referencia oficial en la tabla anterior. Con Yir llamas a MiniMax H3 Image con una sola clave de API y lo comparas con el precio público de cada proveedor.

### ¿MiniMax H3 Image o Nano Banana 2.1? ¿Cuál uso?

Usa MiniMax H3 Image si quieres pesos abiertos para alojarlo o ajustarlo tú mismo más adelante. Usa Nano Banana 2.1 si el precio va primero: su canal 4K más barato en Yir cuesta menos que el de H3 Image y tiene más proveedores de respaldo.

### ¿Cuántos píxeles tiene una imagen 4K de MiniMax H3 Image?

Entre 16 y 17 megapíxeles. En KIE, 4K es 4096 × 4096 en 1:1, 5472 × 3072 en 16:9 y 6272 × 2688 en 21:9; la ruta oficial llega a 5440 × 3072 en 16:9.

### ¿Qué tan rápido genera MiniMax H3 Image en 4K?

MiniMax dice que una imagen 4K tarda menos de 10 segundos en su propia plataforma. En nuestra prueba de seis imágenes 4K desde texto en KIE, el procesamiento tardó de 23 a 39 segundos, con una mediana de unos 28 (noviembre de 2026).

### ¿MiniMax H3 Image puede escribir texto en las imágenes?

Sí. En el mapa de senderos de esta página, el título, las etiquetas y la leyenda salieron tal como se escribieron, aunque el modelo añadió una línea "EST. 1925" que no pedimos. Pon el texto exacto entre comillas e indica dónde va.

### ¿MiniMax H3 Image es de código abierto?

Los pesos son públicos en Hugging Face como MiniMaxAI/MiniMax-H3-Image, así que más adelante puedes alojarlo o ajustarlo tú mismo. A través de Yir llamas a la API oficial de MiniMax o a KIE, sin desplegar nada.

## Reglas

- Autentícate con Authorization: Bearer $YIR_API_KEY; guarda la clave en una variable de entorno del servidor, nunca en código de navegador, control de versiones, prompts ni registros.
- Las tareas son asíncronas: guarda el Job ID, espera a un estado final y luego lee el resultado; gestiona los fallos y las cancelaciones.
- Para reintentar de forma segura, reutiliza la misma clave de idempotencia y la misma solicitud; no reenvíes a ciegas cuando el resultado sea desconocido.
- Las URL de resultados son temporales; copia los archivos a otro lugar si necesitas conservarlos.

## Enlaces

- [Inicio rápido](https://yir.ai/docs/getting-started/quickstart)
- [Referencia de la API](https://yir.ai/docs/reference)
- [llms.txt](https://yir.ai/llms.txt)