MiniMax H3-Image es un modelo de imágenes de pesos abiertos de MiniMax, lanzado el 10 de noviembre de 2026, que genera y edita imágenes a unos 16 megapíxeles (4096 x 4096) sin necesidad de un upscaler. Según MiniMax, una imagen 4K tarda unos 10 segundos. Puedes llamarlo a través de la API de MiniMax, usarlo en Hailuo AI y MiniMax Code, o descargar los pesos desde Hugging Face.
Esta guía explica qué es MiniMax H3-Image, qué afirma realmente MiniMax, qué significa "open-weight" bajo su licencia, cuánto cuesta durante el descuento de la semana de lanzamiento y cómo probar la API desde tu agente de programación.
¿Qué es MiniMax H3-Image?
MiniMax H3-Image es un modelo de texto a imagen y edición de imágenes de la familia MiniMax H3. Un único checkpoint se encarga de ambas tareas: crea imágenes a partir de un prompt y edita hasta 16 imágenes de referencia. Genera unos 16 megapíxeles en cualquier relación de aspecto, desde 4096 x 4096 (1:1) hasta 6272 x 2688 (21:9), y sus pesos se publican bajo una licencia comunitaria.
En el anuncio de lanzamiento en X de MiniMax, la propuesta es breve: "generación de imágenes 4K en 10 segundos", 16 millones de píxeles, realismo, seguimiento preciso de prompts y edición, hasta 16 imágenes de referencia y pesos abiertos.
H3-Image es independiente del modelo de programación de MiniMax, del que trata la explicación sobre MiniMax M3, y tiene sus propios endpoints de API.
Lo que afirma MiniMax sobre H3-Image
Esto es lo que MiniMax publica en la ficha del modelo en Hugging Face y en el anuncio. Trata las afirmaciones de velocidad y calidad como declaraciones de MiniMax; nadie ajeno a la empresa había publicado mediciones independientes al escribir este artículo.
| Afirmación | Lo que dice MiniMax | Dónde |
|---|---|---|
| Resolución | Unos 16 MP, 4096 x 4096 en 1:1, hasta 6272 x 2688 en 21:9, sin upscaler | Ficha del modelo |
| Velocidad | Una imagen 4K en unos 10 segundos | Post de lanzamiento |
| Muestreo | Destilado a 6 pasos de muestreo, sin classifier-free guidance | Ficha del modelo |
| Referencias | Hasta 16 imágenes de referencia por edición | Ficha del modelo, guía de API |
| Seguimiento de instrucciones | "El mejor seguimiento de instrucciones entre los modelos de código abierto" | Ficha del modelo |
| Rango de trabajo | De unos 4 MP a 20 MP, mejores resultados alrededor de 16 MP | Ficha del modelo |
La afirmación de velocidad se basa en 6 pasos destilados y en la ausencia de classifier-free guidance, que normalmente duplica el trabajo por paso. MiniMax no revela el hardware detrás de la cifra de 10 segundos, así que no la tomes como una promesa para tu propia GPU.
La ficha del modelo no publica ninguna tabla de benchmarks que respalde la afirmación sobre el seguimiento de instrucciones. Nuestro artículo hermano, MiniMax H3-Image vs Nano Banana 2.1, compara ambos modelos lado a lado.
Qué hay dentro del modelo
La ficha del modelo es inusualmente específica sobre la arquitectura:
- Transformer de difusión: 33.100 millones de parámetros, un transformer denso de un solo flujo con 50 capas, almacenado en BF16 (68,65 GB).
- Codificador de texto: el codificador de texto de MiniMax-H3, sin cambios, cargado desde el repositorio independiente de MiniMax-H3 (66,7 GB).
- VAE de imagen: submuestreo espacial de 16x y 24 canales latentes (2,34 GB).
- Expansor de prompts opcional: MiniMax-H3-Image-PE (17,9 GB, NVFP4), que convierte un prompt breve en la descripción detallada en inglés que el modelo espera.
Si lo sumas todo, una configuración local completa descarga unos 137 GB, sin contar el expansor opcional.
Qué significa "open-weight" para MiniMax H3-Image
MiniMax H3-Image es de pesos abiertos, no de código abierto en el sentido de la OSI. Puedes descargar y ejecutar los pesos, pero la Licencia Comunitaria de MiniMax-H3-Image impone límites reales. Léela antes de construir sobre él. Los puntos que afectan a la mayoría de los equipos:
- Territorio. La licencia otorga derechos en todo el mundo excepto en los "Territorios Excluidos": la Unión Europea, el Reino Unido, la República de Corea y los Estados Unidos. Los equipos de esos lugares deben contactar con MiniMax para una licencia aparte.
- Ingresos y alojamiento. Necesitas autorización previa por escrito de MiniMax si tú y tus filiales generan más de un millón de dólares de ingresos anualizados, o si ofreces el modelo como servicio alojado a terceros. Las solicitudes se tramitan a través de la consola de licencias de MiniMax.
- Atribución. Los productos comerciales deben mostrar "MiniMax-H3-Image" de forma destacada en la interfaz de usuario.
- Sin entrenar otros modelos. No puedes usar el modelo ni sus resultados para mejorar cualquier otro modelo de IA.
- Divulgación. La política de uso aceptable prohíbe publicar contenido generado públicamente sin divulgar claramente que ha sido generado por una máquina.
MiniMax no reclama derechos sobre las imágenes que generes. Si solo usas la API alojada, consulta también los términos de la plataforma de MiniMax para ese uso.
Dónde puedes usar MiniMax H3-Image
Tienes cuatro vías de acceso:
- API de MiniMax. Texto a imagen en
POST https://api.minimax.io/v1/images/generationsy edición en/v1/images/edits, ambos con el ID de modeloMiniMax-H3-Imageo el más rápidoMiniMax-H3-Image-Highspeed. El recorrido completo está en nuestra guía de la API de MiniMax H3-Image. - Hailuo AI. La aplicación web de MiniMax, sin necesidad de código.
- MiniMax Code. La aplicación de escritorio de MiniMax para macOS y Windows, mencionada en el post de lanzamiento como un lugar para usar H3-Image.
- Autoalojamiento. MiniMax recomienda SGLang, vLLM-Omni, diffusers o ComfyUI, y enumera las NVIDIA H200, RTX PRO 6000 Blackwell y AMD Instinct MI350X entre los aceleradores compatibles. La ficha del modelo no indica una cifra mínima de VRAM.
Si buscas opciones gratuitas, el artículo MiniMax H3-Image for free las cubre.
Cómo funciona la API de MiniMax H3-Image
La API sigue un formato de imágenes similar al de OpenAI, así que la solicitud es breve:
curl https://api.minimax.io/v1/images/generations \
-H "Authorization: Bearer $MINIMAX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3-Image",
"prompt": "An orange cat on a sunny windowsill, film texture",
"aspect_ratio": "16:9",
"area": "4K",
"response_format": "url"
}'
Los parámetros que vale la pena conocer, según la referencia de la API:
sizeaceptaWIDTHxHEIGHT(de 655.360 a 20.000.000 píxeles, relación de aspecto entre 1:3 y 3:1) oauto. Conauto, en su lugar establecesaspect_ratioyarea(1K,2Ko4K, por defecto4K). Mezclar ambas formas devuelve un 400.nsolicita de 1 a 10 imágenes por solicitud.output_formatesjpegpor defecto, opngowebp.response_formatesurl(descárgala tú mismo, ya que no se garantiza que la URL perdure) ob64_json.stream: trueenvía cada imagen mediante server-sent events a medida que termina.- La mejora de prompts está activada por defecto. Cada resultado incluye un
revised_promptque muestra lo que el modelo usó realmente. Establecedisable_prompt_enhanced: truepara enviar tu prompt tal cual.
Un comportamiento confunde a mucha gente: si al menos una imagen se genera correctamente, la llamada devuelve HTTP 200 incluso cuando otras fallan la comprobación de seguridad de contenido. Revisa data[].error en cada elemento. Solo se facturan las imágenes generadas con éxito.
La guía también enumera lo que no está soportado: imágenes de vista previa, ediciones con máscara y fondos transparentes.
Para editar, pasas de 1 a 16 imágenes de referencia como URLs públicas, IDs de archivos subidos o data URIs, con un total máximo de 64 MiB por solicitud. Tu prompt las referencia como <Picture 1>, <Picture 2> y así sucesivamente, en el orden de subida.
Precios de MiniMax H3-Image y descuento de la semana de lanzamiento
MiniMax factura H3-Image por millón de tokens, dividido en entrada de texto, entrada de imagen y salida de imagen. Según la página de precios de MiniMax, consultada el 11 de noviembre de 2026:
| Modelo | Texto de entrada / M tokens | Imagen de entrada / M tokens | Imagen de salida / M tokens |
|---|---|---|---|
| MiniMax-H3-Image | $2.30 | $1.50 | $3.80 |
| MiniMax-H3-Image-Highspeed | $2.30 | $3.00 | $7.60 |
Los costes de ejemplo del propio MiniMax por resultado de texto a imagen en el modelo estándar son $0.02179 en 1K, $0.02333 en 2K y $0.06879 en 4K. El ejemplo 4K de Highspeed cuesta $0.13001.
El descuento de lanzamiento es del 50% sobre el coste total de la solicitud en ambos modelos cuando la imagen entregada tiene al menos 16.600.000 píxeles. Estará vigente hasta el 17 de noviembre de 2026 a las 16:00 UTC. Durante ese periodo, MiniMax muestra un resultado 4K de texto a imagen estándar a $0.03439 y uno de Highspeed a $0.06501. Las imágenes más pequeñas no se benefician del descuento, así que una imagen en 2K cuesta lo mismo que antes.
Prueba la API de MiniMax H3-Image con Apidog CLI
Antes de integrar H3-Image en una aplicación, comprueba que el formato de tu solicitud, la autenticación y el manejo de errores funcionan, incluido el caso de "200 con un elemento fallido". Deja que tu agente de programación construya y ejecute esa comprobación con Apidog CLI en lugar de hacerlo manualmente a base de clics.
![Workflow diagram: a coding agent uses Apidog CLI to create an endpoint and test case, calls POST /v1/images/generations on MiniMax H3-Image, reads a test report checking status 200, data[0].url and no data[].error, then fixes and reruns](https://assets.apidog.com/blog-next/2026/11/minimax-h3-apidog-loop.png)
Configura el CLI una sola vez:
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_APIDOG_TOKEN>
apidog skill install
El skill enseña a tu agente (Claude Code, Codex, Cursor u otro) los comandos del CLI. Luego dale un solo prompt:
In Apidog project <projectId>, add the MiniMax H3-Image endpoint
POST /v1/images/generations from https://platform.minimax.io/docs/api-reference/image-generation-h3-generations
with Bearer auth from {{MINIMAX_API_KEY}}. Create an environment with base URL
https://api.minimax.io. Write a test case that sends model MiniMax-H3-Image,
area 1K, n 1, and asserts status 200, data[0].url exists, data[0].error is absent
and usage.generated_images equals 1. Run it and summarize the result.
El agente lo convierte en una breve serie de comandos de apidog. Todos los flags que aparecen a continuación provienen de apidog <command> --help en Apidog CLI 2.2.12:
apidog environment create --project <projectId> --base-url https://api.minimax.io
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file ./h3-endpoint.json
apidog endpoint create --project <projectId> --file ./h3-endpoint.json
apidog test-case category --project <projectId>
apidog cli-schema validate test-case-create --file ./h3-case.json
apidog test-case create --project <projectId> --file ./h3-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> \
--env-var "MINIMAX_API_KEY=$MINIMAX_API_KEY" -r cli,json
cli-schema get le entrega al agente la forma JSON exacta, y cli-schema validate comprueba cada archivo antes de escribir nada. test-case category le proporciona un ID de categoría válido para que el caso aparezca en la aplicación. La ejecución imprime un resumen de aprobación o fallo en tu terminal y genera un informe JSON que el agente lee para decidir qué corregir. Añade --upload-report para ver la misma ejecución en Apidog.
Usar area: 1K mantiene cada llamada de prueba en el precio de ejemplo más bajo publicado por MiniMax. Para más detalles sobre este patrón, consulta el flujo de trabajo del agente con Apidog CLI y Apidog CLI en Claude Code. El plan gratuito de Apidog cubre hasta 4 usuarios.
¿Deberías probar MiniMax H3-Image?
Pruébalo si necesitas imágenes grandes y detalladas y quieres una opción de pesos abiertos, o si la edición con múltiples referencias (fotos de productos, distribuciones de habitaciones, hojas de personaje) es tu caso de uso. El descuento de lanzamiento hace que las pruebas en 4K sean baratas hasta el 17 de noviembre.
Piénsalo dos veces antes de autoalojarlo: unos 137 GB de pesos, GPUs de centro de datos y una licencia que excluye a la UE, el Reino Unido, la República de Corea y los EE. UU. Para la mayoría de los equipos, la API es el camino práctico. Si estás comparando APIs de imágenes, nuestras guías sobre la API de GPT Image 2.6, la API de Nano Banana 2.1 y Qwen-Image 2.1 cubren las alternativas.
FAQ
¿Es gratuito MiniMax H3-Image? Los pesos se pueden descargar y ejecutar sin regalías dentro de los territorios permitidos por la licencia, respetando sus límites de ingresos y alojamiento. La API es de pago por token. Consulta nuestra guía de acceso gratuito para ver las opciones sin coste.
¿Es de código abierto MiniMax H3-Image? MiniMax lo denomina open-source en Hugging Face, pero se distribuye bajo una licencia comunitaria personalizada con restricciones de territorio, ingresos, atribución y prohibición de entrenar otros modelos. "Open-weight" es el término más preciso.
¿Qué tan rápido es MiniMax H3-Image? MiniMax dice que una imagen 4K tarda unos 10 segundos. Esa es la cifra de la empresa; no menciona el hardware, y no existía ningún benchmark independiente al escribir este artículo.
¿Cuál es la diferencia entre MiniMax-H3-Image y MiniMax-H3-Image-Highspeed? Ambos aceptan los mismos parámetros y límites. Highspeed es la variante más rápida y cuesta más: $7.60 por millón de tokens de imagen de salida frente a $3.80.
¿Cuántas imágenes de referencia puede usar MiniMax H3-Image? Hasta 16 por solicitud de edición, cada una de 128 a 8192 píxeles por lado, con todo el cuerpo de la solicitud limitado a 64 MiB.
¿Cuándo termina el descuento de lanzamiento de MiniMax H3-Image? El 17 de noviembre de 2026 a las 16:00 UTC. Solo se aplica a imágenes de al menos 16.600.000 píxeles.