Precio de lanzamiento (hasta el 25 de dic.), se mantiene mientras sigas suscrito: Go por $10/mes (antes $20), Plus con Opus 5.5 por solo $30/mes (antes $50)Suscribirme →

API de MiniMax H3-Image: coste 4K, límites y VRAM (2026)

MiniMax H3-Image promete generación en la clase de 4096 × 4096: según la tabla de latencia de MiniMax, alcanza un P50 de 10,3 segundos en Highspeed y de 16,0 segundos en Standard. Para texto a imagen directo a 4K, su coste de ejemplo en Standard ($0.06879) es inferior al de la alternativa alojada por terceros recogida en este artículo (WaveSpeed: $0.03 por imagen a 1K/2K y $0.09 a 4K). Highspeed ($0.13001) queda por encima. Sin embargo, si la edición con varias referencias debe conservar una identidad, los testimonios enlazados sugieren buscar otra opción.

4K en unos 10 segundos, pero las primeras pruebas de edición no convencen

H3-Image es un nuevo modelo de imagen con pesos abiertos basado en el vídeo MiniMax H3. Genera imágenes desde texto, trabaja con referencias y permite editar; admite hasta 16 imágenes de referencia y hasta 10 resultados por solicitud. Sus niveles de área 1K/2K/4K apuntan a 1.048.576 / 4.194.304 / 16.777.216 píxeles. El servidor calcula la anchura y altura exactas según la relación de aspecto y las devuelve en data[].size: 4K es un área objetivo, no necesariamente un cuadrado literal de 4096×4096.

MiniMax comunica buenas cifras de latencia P50, aunque la comparación a 4K es limitada. Su gráfica de latencia P50 indica 7,7 s a 1K y 10,3 s a 4K para texto a imagen en Highspeed, frente a 10,6 s y 16,0 s en Standard. A 4K, la gráfica solo compara con Nano Banana 2.1 (50–51 s), por lo que la afirmación de ser «5x más rápido que las alternativas generalistas» se apoya en una muestra muy estrecha.

En los hilos de Reddit enlazados, los comentarios confirman un T2I rápido, pero repiten dos carencias: pérdida de parecido con las referencias y detalle blando en la resolución anunciada.

«Por desgracia, como modelo ref2i es muy malo comparado con el propio modelo de vídeo H3 para ref2i». — u/Omegapepper en r/StableDiffusion

«Puede que la gente se enfade conmigo, pero por lo que he probado es significativamente inferior a QI 2.1 [...] para edición con múltiples referencias». — u/Crazy-Repeat-2006 en r/StableDiffusion

En el hilo sobre tamaños recomendados, quienes lo han probado describen suavidad y desenfoque en resultados de baja resolución que deberían verse nítidos, y debaten si la alta resolución declarada contiene de verdad detalle de alta frecuencia. Son observaciones tempranas y anecdóticas, no un benchmark controlado, pero todas apuntan en la misma dirección.

Qué ofrece realmente la API: dos modelos, dos endpoints y expansión de prompts

La documentación de la API de MiniMax incluye dos identificadores de modelo, dos endpoints de imagen y un paso de expansión del prompt.

ElementoMiniMax-H3-Image (Standard)MiniMax-H3-Image-Highspeed
ObjetivoMenor coste por imagenMenor latencia
Entrada de texto$2.30 / 1M tokens$2.30 / 1M tokens
Entrada de imagen$1.50 / 1M tokens$3.00 / 1M tokens
Salida de imagen$3.80 / 1M tokens$7.60 / 1M tokens

Endpoints (a continuación se muestra el host Global; las cuentas de China usan el endpoint de China indicado en la misma documentación):

  1. POST https://api.minimax.io/v1/images/generations — texto a imagen; los parámetros verificados incluyen model, prompt (máximo 32.000 caracteres), disable_prompt_enhanced (por defecto false), n (1–10), size (auto o WIDTHxHEIGHT), aspect_ratio, area (1K/2K/4K, 4K por defecto), output_format (jpeg por defecto), response_format (url/b64_json), stream y output_compression.
  2. POST /v1/images/edits — edición con entre 1 y 16 referencias; las referencias aceptan JPG/PNG/WebP/HEIC/HEIF, de 128 a 8192 px por lado.
  3. H3-Image-Context-IR — paso de expansión de prompts, no un endpoint de imagen, que reescribe un prompt breve y elige una relación de aspecto.

Ejemplo listo para copiar y pegar (host Global):

bash
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":"...","size":"auto","aspect_ratio":"16:9","area":"2K","disable_prompt_enhanced":false,"response_format":"url"}'

La documentación especifica que las solicitudes no son idempotentes, que el servidor puede tardar hasta 600 segundos y que la generación continúa aunque el cliente agote el tiempo de espera o se desconecte. Una imagen completada se cobra igualmente, y solo se facturan las imágenes correctas (usage cuenta los éxitos). MiniMax recomienda max_retries=0 con el SDK de OpenAI. Un éxito parcial devuelve HTTP 200 con entradas data[].error para cada imagen, incluidos fallos de seguridad de contenido; hay que revisar cada elemento. Solo los lotes en los que todo falla devuelven 4xx/5xx. Trata la mayoría de errores 4xx como errores terminales de configuración, no repitas nunca un POST tras un timeout ambiguo y, con proveedores asíncronos, consulta el trabajo existente en lugar de enviar otro.

La mejora de prompts está activada por defecto. Puede desactivarse para texto a imagen, pero no para ediciones, y la API devuelve el prompt reescrito en data[].revised_prompt. Regístralo y compáralo con el prompt enviado antes de ajustar cualquier otra variable. Ten presentes los límites al desactivar el mejorador: el modelo leerá aproximadamente los primeros 4.096 tokens y deberás indicar un tamaño exacto o una relación de aspecto explícita.

Autoalojarlo no son 10 segundos: pesos, VRAM y licencia

Los pesos están disponibles en Hugging Face MiniMaxAI/MiniMax-H3-Image y GitHub MiniMax-AI/MiniMax-H3-Image, junto con pesos convertidos para ComfyUI y una plantilla de flujo de trabajo image_minimax_h3_image_t2i.json. La ficha documenta un transformer de difusión de 33.1B parámetros, un checkpoint BF16 de 68.65 GB y un codificador de texto H3 independiente de 66.7 GB: unos 135 GB antes del expansor opcional de prompts de 17.9 GB. También fija el servidor local en 6 pasos de inferencia y escala de guidance 1; otros valores devuelven HTTP 400 en ese entorno, y no admite prompts negativos.

No cuentes con obtener 10 segundos en una tarjeta gaming. En los hilos de ComfyUI se preguntan si el modelo cabe en una 5090 incluso con cuantización a 4 bits. En el hilo enlazado sobre los pesos abiertos, un usuario de RTX 5090 informa de unos 21 segundos para 16 MP en INT8, con salida granulada, y de necesitar BF16 para conseguir nitidez a costa de más tiempo. Un usuario de RTX 3070 Ti en el hilo de ComfyUI considera rápido el T2I para salida de 16 MP, pero afirma que la edición con referencias ignoraba el prompt. Es un único dato de usuario, no una prueba de que la cuantización agresiva sea segura para trabajar con referencias.

Para muchos equipos, la licencia importa más que la VRAM. La ficha del modelo usa el MiniMax-H3-Image Community License Agreement, fechado el 10 de noviembre de 2026: la licencia por defecto excluye Estados Unidos, la Unión Europea, Reino Unido y la República de Corea; exige autorización previa por escrito a partir de $1M de ingresos anualizados o para servicios alojados destinados a terceros, y obliga a que las interfaces comerciales muestren «MiniMax-H3-Image». Los equipos radicados en Estados Unidos o la UE deberían aclarar la licencia antes de autoalojarlo.

Coste de una imagen a 1K, 2K y 4K: cálculos de ejemplo de MiniMax

Todas las cifras siguientes son costes de ejemplo proporcionados por MiniMax, no precios fijos: la facturación se basa en tokens, así que la longitud del prompt y el número de referencias alteran el total. Los ejemplos suponen imágenes de referencia 1K cuando intervienen referencias.

TareaEjemplo StandardEjemplo Highspeed
T2I área 1K$0.02179$0.03529
T2I área 2K$0.02333$0.03622
T2I área 4K$0.06879 ($0.03439 promo)$0.13001 ($0.06501 promo)
Edición 4K + 1 referencia$0.07312 ($0.03656 promo)$0.13673 ($0.06837 promo)
Edición 4K + 3 referencias$0.07914 ($0.03957 promo)$0.15407 ($0.07703 promo)

Hay tres formas de ahorrar. La primera: 2K cuesta casi lo mismo que 1K ($0.02333 frente a $0.02179) para 4 veces más píxeles objetivo; elige 2K antes que 1K cuando ambos sirvan. La segunda: 4K aporta 16 veces los píxeles de 1K por alrededor de 3,2 veces el precio de ejemplo, de modo que el 4K nativo resulta eficiente si necesitas detalle de impresión. La tercera: la promoción de lanzamiento reduce a la mitad el 4K que cumpla los requisitos, hasta $0.03439 en Standard, hasta el 17 de noviembre de 2026 a las 16:00 UTC, para resultados de al menos 16.600.000 píxeles.

Highspeed aproximadamente duplica las tarifas de tokens de imagen para ahorrar entre 3 y 7 segundos. En T2I 4K son $0.13001 frente a $0.06879 (1.89x). Salvo que generes catálogos por lotes con un SLO de latencia, Standard sale ganando. Cada referencia adicional añade tokens de imagen de entrada, por lo que una edición 4K con 3 referencias cuesta aproximadamente un 8% más que una con 1 referencia, incluso antes de considerar la calidad.

¿Conviene esta API o Qwen, Krea o H3 video?

Para generar por lotes imágenes de alta resolución a partir de texto, H3-Image resulta atractivo según los ejemplos de precio y latencia publicados por MiniMax. Si el trabajo exige preservar una identidad, compara las alternativas siguientes antes de comprometerte.

Caso de usoElecciónMotivo
Pósteres, fondos y paisajes 4K T2I por lotesH3-Image StandardEjemplos de $0.023 para 2K y $0.069 para 4K; el 4K más rápido en la gráfica de MiniMax
Lotes sensibles a latencia (anuncios, previsualizaciones en vivo)H3-Image HighspeedDe 7,7 s a 1K a 10,3 s a 4K; se paga 1,9x por ahorrar ~6 s
Consistencia de personajes o productos con múltiples referenciasQwen Image mediante Alibaba Cloud o H3 video ref2iLos hilos enlazados sitúan H3-Image por debajo de QI 2.1 en ediciones multirreferencia; varios usuarios siguen usando H3 video para ref2i
Interfaz de edición gestionada en lugar de API/autoalojamientoKreaSin una huella local de ~135 GB; es una alternativa de interfaz, no un equivalente de API
Autoalojamiento con 24GB o menosEsperar a compilaciones pruned/INT4BF16 requiere hoy VRAM de clase datacenter

Cuando el parecido importa, el ahorro aparente por imagen desaparece entre reintentos.

Checklist de despliegue para no pagar por imágenes borrosas

  • Empieza con los preajustes 1K/2K y escala a 4K solo los resultados que merezcan la pena; quienes lo han probado informan de un 4K predeterminado blando, así que comprueba antes la nitidez a 2K.
  • Registra revised_prompt en cada ejecución y compáralo con el prompt enviado antes de modificar nada más.
  • Configura timeouts de cliente por encima de 600 s, ya que el servidor puede tardar hasta 600 s; desactiva los reintentos automáticos del SDK, guarda una clave de deduplicación del lado del cliente solo para conciliación y, con proveedores asíncronos, consulta el trabajo en vez de repetir el POST.
  • Gestiona las entradas data[].error de cada imagen dentro de lotes multiresultado que devuelven HTTP 200; revisa la referencia de edits para conocer el formato de error antes de programar el bucle.
  • Confirma la licencia, response_format y la descarga de prompts: según la documentación de la API, las respuestas url no garantizan almacenamiento duradero.

Preguntas frecuentes sobre la API de MiniMax H3-Image

¿Qué diferencia hay entre MiniMax H3-Image y MiniMax H3?

H3 es el modelo de vídeo; H3-Image es el modelo de imagen fija construido sobre él para texto a imagen y edición en áreas de clase 4K. Para la consistencia de referencia a imagen, varios usuarios de los hilos enlazados siguen prefiriendo H3 video.

¿Cuál es el endpoint oficial y el ID de modelo?

POST https://api.minimax.io/v1/images/generations con model: MiniMax-H3-Image o MiniMax-H3-Image-Highspeed, además de /v1/images/edits y H3-Image-Context-IR para la expansión de prompts.

¿Puedo desactivar la mejora de prompts?

En texto a imagen, sí: disable_prompt_enhanced: true. En edición, no. La API devuelve el prompt reescrito que ha utilizado.

¿Puedo ejecutar H3-Image localmente con una GPU de consumo?

Solo con cuantización y paciencia: ~135 GB en BF16 antes del expansor de prompts. La ficha del modelo menciona aceleradores de clase H200, RTX PRO 6000 y MI350X para las configuraciones de servidor.

¿Se puede usar comercialmente?

Solo tras aclarar la MiniMax-H3-Image Community License: la licencia por defecto excluye Estados Unidos, la UE, Reino Unido y Corea, y requiere autorización por encima de $1M de ingresos o para servicios alojados de terceros.