MiniMax H3 Image API
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
- 1K
- KIE 0,0115 $ / imagen
- Oficial
≈0,0312 $63%–72% menos - 2K
- KIE 0,0115 $ / imagen
- Oficial
≈0,0328 $65%–72% menos - 4K
- KIE 0,03 $ / imagen
- Oficial
≈0,0782 $62%–69% menos
Precios de la API de MiniMax H3 Image por imagen
KIE cobra un precio fijo por nivel, cerca del 40 % del precio de lista de MiniMax, más $0.0025 por cada imagen de referencia. El precio oficial es una estimación por tokens y no incluye el 50 % de descuento en 4K de la semana de lanzamiento
Enrutamiento automático y failover
Llama a MiniMax H3 Image con un solo ID de modelo y Yir elige el canal de cada tarea entre MiniMax y KIE: la envía al canal disponible con el precio estimado más bajo y la cobra al precio público de ese canal, sin recargo. Si un intento falla, lo reintenta en otro canal sin superar tu max_cost. No necesitas parámetros de enrutamiento en tu solicitud. Documentación de enrutamiento y failover
Notas de precios
Se cobra según el proveedor que realmente ejecuta la tarea. El failover puede cambiar de proveedor, lo que puede modificar el costo y el tiempo.
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
Generaciones de ejemplo
Todas las imágenes de aquí las generó MiniMax H3 Image. Abre una para probar su prompt original en el playground
Recortada al 100 %, sigue aguantando
Cada recuadro es un recorte 1:1 de un original 4K de arriba, cerca del 7 % de la imagen
Etiquetas de especias escritas a mano
Manos curtidas sobre la red
Gotas de rocío en la telaraña
Alguien en la escalera de la biblioteca
Usar la API
Deja el código a un agente de programación, genera en el chat con MCP o la Skill, o intégralo tú mismo con el SDK o la API compatible con OpenAI.
Deja que un agente de programación lo integre
Copia el prompt de integración o ábrelo directamente en Codex o Claude. El agente lee esta página y el contrato del modelo, y luego escribe en tu proyecto el envío, la espera y el manejo de resultados.
Añade el servidor MCP de Yir
Conéctalo a ChatGPT, Claude o Cursor, menciona @Yir y pide MiniMax H3 Image por su nombre. Primero te da el precio y solo genera cuando confirmas.
https://gateway.yir.ai/mcpUn comando para Claude Code
Crea una API key en la consola, guárdala como YIR_API_KEY y ejecuta:
claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"Instala la Skill de Yir
Define YIR_API_KEY donde se ejecuta tu agente, añade la Skill a Claude Code, Codex u otro agente de programación y di “usa MiniMax H3 Image en Yir para crear…”.
npx skills add yir-ai/skillsInstala el SDK oficial con tu gestor de paquetes o copia el fragmento de código de abajo para empezar
| import { createNodeYirClient } from "@yir-ai/sdk/server"; |
| // Lee YIR_API_KEY del entorno por defecto: process.env.YIR_API_KEY |
| const client = createNodeYirClient(); |
| // 1. Envía una tarea de generación de imagen |
| 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. Espera a que la tarea termine y entregue el resultado |
| const result = await client.waitForJob(job.id); |
| console.log("Archivos entregados:", result.result); |
| if (result.result && "files" in result.result) { |
| for (const file of result.result.files) { |
| console.log("->", file.url); |
| } |
| } |
Los proyectos que ya usan el protocolo de OpenAI, o gateways como new-api, solo necesitan una nueva Base URL y una nueva clave. Guía de compatibilidad con OpenAI
- base_url del SDK de OpenAI
https://gateway.yir.ai/openai/v1- Base URL del canal en new-api
https://gateway.yir.ai/openai- Clave
- API Key de Yir
- ID del 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": "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"
}'Resumen de parámetros
Parámetros comunes; los límites dependen del modelo actual y del proveedor seleccionado
- Resolución resolution
- 1K
- 2K
- 4K
Nivel de resolución de salida. Las resoluciones más altas dan mayor nitidez y el precio aumenta en consecuencia
- Relación de aspecto aspect_ratio
- 1:1
- 2:3
- 3:2
- 3:4
- 4:3
- 4:5
- 5:4
- 9:16
- 16:9
- 21:9
Proporción geométrica. Elígela según el medio de destino (vertical, banner o cuadrado)
- Modo de entrada input_mode
- Entrada de texto
- Entrada de imagen
Los límites y formatos de las referencias dependen del modelo y del proveedor seleccionado
- Referencias references
- reference_image ≤ 16
Los límites por modo dependen del proveedor elegido. Las cantidades de la tabla son ejemplos de precio, no límites ni cuotas gratuitas.
