MiniMax H3 Image API: generación, edición y precios reales

Precios del mismo modelo entre proveedores: Cheap MiniMax H3 Image API · 2026-11-13

Capacidades de MiniMax H3 Image y límites de la API alojada

La razón más sólida para evaluar H3 Image es su flujo de trabajo unificado de generación y edición: describa un nuevo recurso, proporcione referencias de producto o personaje y luego solicite un cambio específico. MiniMax también publica los pesos para despliegue local. Las capacidades publicadas no garantizan la preservación exacta de logotipos, tipografía o identidad en cada salida.

Función de la API alojada	Contrato documentado
Generación	POST /v1/images/generations
Edición	POST /v1/images/edits, 1–16 imágenes de referencia
Prompt	Hasta 32,000 caracteres; sin mejora, solo los primeros 4,096 tokens aproximadamente surten efecto
Dimensiones de salida	655,360–20,000,000 píxeles; relación de aspecto de 1:3 a 3:1
Cantidad de salidas	n de 1 a 10
Formatos	JPEG por defecto; se admiten PNG o WebP
Respuestas	URL o Base64 sin streaming; se admite SSE nativo
Controles no admitidos	Edición con máscara, fondos transparentes e imágenes de vista previa

Los archivos de referencia deben cumplir los límites de entrada de MiniMax: JPG/JPEG, PNG, WebP, HEIC o HEIF, cada dimensión de 128–8,192 píxeles, relación del lado largo al corto como máximo 4:1 y cuerpo total de la solicitud de como máximo 64 MiB. Base64 incrementa el tamaño de la solicitud. Use URLs de imágenes accesibles o cargas de tamaño adecuado; la capacidad del modelo de aceptar 16 imágenes no elimina el límite de tamaño del cuerpo.

“4K” es un ajuste de área en esta API. area: "4K" apunta a aproximadamente 4096 × 4096 píxeles, con dimensiones derivadas de la relación de aspecto. En 16:9, la salida documentada es 5472 × 3072, no 4096 × 2304. Para dimensiones explícitas, envíe size: "WIDTHxHEIGHT" y omita area y aspect_ratio. Para dimensionar por área, use size: "auto", area y aspect_ratio. Verifique data[].size y las dimensiones reales de la imagen descargada.

¿Cuánto cuesta MiniMax H3 Image?

Para la ruta Standard actual de APIMaster, el cálculo a precio regular es:

USD = (text_input_tokens × 2.30
     + image_input_tokens × 1.50
     + image_output_tokens × 3.80) / 1,000,000

Use campos de uso separados para texto e imagen; no cobre todos los tokens de entrada como texto y luego sume de nuevo la entrada de imagen. La mejora de prompt contribuye con tokens de texto facturables, por lo que la resolución por sí sola no determina el precio total. Los coeficientes específicos de cada cuenta, cuando correspondan, y el redondeo de facturación pueden afectar el cargo final.

Los totales ilustrativos oficiales de Standard de MiniMax muestran la escala de la factura. Son ejemplos, no tarifas fijas de APIMaster ni nuestro promedio medido:

Tarea	1K: 1024 × 1024	2K: 2048 × 2048	4K: 4096 × 4096, tarifa regular
Texto a imagen	$0.02179	$0.02333	$0.06879
Edición con una referencia 1K	$0.02654	$0.02658	$0.07312
Edición con tres referencias 1K	$0.03563	$0.04177	$0.07914

Como contexto, 1,000 solicitudes de texto a imagen con el primer ejemplo serían aproximadamente $21.79; ese es un cálculo ilustrativo de presupuesto de tokens, no un paquete prepago. Los prompts reales y la mejora pueden modificarlo. Nano Banana 2.1 tiene un contrato distinto en APIMaster basado en resolución, desde $15.12 por 1,000 imágenes 1K antes de cualquier condición cotizada por separado.

¿Se aplica en APIMaster la promoción oficial del 50% en 4K?

No asuma que sí. MiniMax anuncia un 50% de descuento sobre el costo total de la solicitud para Standard y Highspeed hasta el 17 de noviembre de 2026, 16:00 UTC, exclusivo—18 de noviembre a las 00:00 hora de Beijing—cuando la imagen final entregada tenga al menos 16,600,000 píxeles. Su ejemplo cuadrado de texto a imagen 4K cambia de $0.06879 a $0.03439 durante esa oferta.

Una salida de 4096 × 4096 califica por área; 4096 × 2304 no. La mera etiqueta “4K” es insuficiente. La ruta pública actual de APIMaster usa tarifas regulares por tokens, sin esta promoción temporal. Compare el contrato real de pago/uso, no el titular de la campaña de MiniMax. Tras la fecha límite, los ejemplos promocionales no deberían usarse como precios vigentes.

Ejemplo de la API de MiniMax H3 Image: texto a imagen

Cree una cuenta de APIMaster, agregue saldo para solicitudes de imagen pagadas y luego cree una clave en API keys. Configure APIMASTER_API_KEY en su entorno. Este ejemplo usa el ID de modelo exacto y sensible a mayúsculas de la ruta Standard:

import os
import requests

base_url = "https://apimaster.ai/v1"
headers = {"Authorization": f"Bearer {os.environ['APIMASTER_API_KEY']}"}
response = requests.post(
    f"{base_url}/images/generations",
    headers=headers,
    json={
        "model": "MiniMax-H3-Image",
        "prompt": "A studio product photo of a matte blue teapot and two pears on a cream table, soft daylight, no text.",
        "size": "auto",
        "aspect_ratio": "16:9",
        "area": "2K",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
response.raise_for_status()
result = response.json()
for item in result.get("data", []):
    if item.get("error"):
        print("Image failed:", item["error"])
    else:
        print(item.get("url"), item.get("size"))
print("Usage:", result.get("usage"))

Este es un ejemplo de solicitud, no un benchmark de calidad de imagen. Descargue las URLs de salida exitosas con prontitud y guarde los archivos usted mismo. Verifique los errores por imagen: con n > 1, un HTTP 200 puede incluir imágenes fallidas. Un timeout no prueba que una solicitud fue rechazada. La generación de H3 no es idempotente, por lo que un reintento automático puede crear otra generación facturada. Si usa el SDK de OpenAI, configure un timeout suficientemente largo y max_retries=0.

Edición con MiniMax H3 Image: imágenes de referencia y control del prompt

Para editar con JSON, envíe las URLs de referencia en images[].image_url. No copie el campo image_urls de Nano Banana en esta solicitud de H3. Reemplace las URLs de ejemplo con sus propios recursos accesibles:

edit = requests.post(
    f"{base_url}/images/edits",
    headers=headers,
    json={
        "model": "MiniMax-H3-Image",
        "prompt": "Keep the product shape and label from image 1. Use the background palette from image 2. Do not add text or change the product.",
        "images": [
            {"image_url": "https://example.com/product.png"},
            {"image_url": "https://example.com/palette.png"},
        ],
        "size": "2048x2048",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
edit.raise_for_status()
print(edit.json())

Las verificaciones de aceptación de la integración del 11 de noviembre ya existentes en APIMaster cubrieron referencias HTTP, data URIs, cargas multipart, edición con múltiples referencias, SSE y salidas decodificadas en 1K/2K/4K. Una prueba controlada con dos referencias conservó cuatro formas de color y dos etiquetas cortas. Estas fueron verificaciones de interfaz y facturación con recursos simples, no una evaluación fotográfica o tipográfica amplia; no establecen superioridad sobre otro modelo.

La generación usa la mejora de prompt por defecto; puede desactivarla con disable_prompt_enhanced: true mientras proporciona dimensiones fijas o una relación de aspecto fija. Las ediciones siempre usan la mejora. Inspeccione revised_prompt al diagnosticar cambios inesperados. Para trabajos de producto, especifique qué debe permanecer fijo, identifique el rol de cada referencia y verifique la etiqueta renderizada antes de publicarla.

Standard vs Highspeed, y pesos abiertos vs API alojada

Highspeed usa los mismos parámetros de API documentados, pero sus tarifas oficiales de entrada y salida de imagen son el doble que las de Standard; la entrada de texto se mantiene en $2.30/M. APIMaster actualmente solo lista Standard. Las afirmaciones de velocidad de lanzamiento de MiniMax dependen de la variante del modelo, el tamaño y el despliegue, y no son una garantía de latencia medida por APIMaster.

El repositorio oficial de Hugging Face proporciona pesos e integraciones que incluyen Diffusers, SGLang, vLLM-Omni y ComfyUI. Su checkpoint BF16 pesa aproximadamente 68.65 GB, con un codificador de texto separado de aproximadamente 66.7 GB. El tamaño de descarga no es una estimación completa de memoria de GPU. Los pesos locales usan la licencia comunitaria de MiniMax H3 Image, así que revise esa licencia antes del despliegue; “pesos abiertos” no significa uso sin restricciones bajo MIT o Apache.

Use el acceso alojado para evaluar prompts sin construir infraestructura de inferencia. Considere el despliegue local cuando el control sobre la inferencia justifique el trabajo de GPU, mantenimiento y licencias. Los límites del pipeline local y los de la API alojada son contratos diferentes.

FAQ

¿MiniMax H3 Image es lo mismo que el video MiniMax H3?

No. H3 Image genera y edita imágenes fijas usando MiniMax-H3-Image. La familia de video H3 tiene IDs de modelo, endpoints y facturación diferentes. Consulte la guía de video MiniMax H3 por separado.

¿MiniMax H3 Image está disponible en APIMaster?

Sí. La verificación del 13 de noviembre encontró una ruta pública Standard habilitada, facturada a $2.30/M de entrada de texto, $1.50/M de entrada de imagen y $3.80/M de salida de imagen. Highspeed no tenía ruta pública. Verifique la ficha activa del modelo antes de enviar solicitudes.

¿H3 Image es una API de precio fijo de $0.02 por imagen?

No. Los ejemplos oficiales por imagen son totales ilustrativos. El uso real de tokens, la mejora de prompt, las entradas de referencia y las dimensiones de salida determinan la factura. La ruta actual de APIMaster usa la fórmula regular de tokens.

¿H3 Image puede editar con 16 referencias o una máscara?

Documenta hasta 16 imágenes de referencia dentro de los límites de formato y tamaño de solicitud. La edición con máscara y los fondos transparentes no son compatibles. Las instrucciones basadas en referencias no garantizan una preservación exacta a nivel de píxel.

¿Qué es más barato: H3 Image o Nano Banana 2.1?

Para la tarea ilustrada de texto a imagen 1K, el ejemplo oficial regular de H3 es $0.02179, frente a APIMaster Nano Banana 2.1 desde $0.01512 por imagen 1K. Esto compara un total de tokens de ejemplo con una cotización por resolución; mida el costo real de salida aceptada para sus prompts. Consulte la comparación dedicada.

Fuentes y próximos pasos

Fuentes verificadas el 13 de noviembre de 2026: lanzamiento de MiniMax, guía de la API alojada, precios y promoción oficiales, pesos del modelo y licencia, precios de imágenes de Google y las fichas activas del marketplace de APIMaster. Las descripciones de capacidades provienen de sus respectivos proveedores; las verificaciones de precios y las observaciones fechadas de la integración con APIMaster se identifican por separado.

Abra la ficha de H3 Image, regístrese, cree una clave de API y envíe MiniMax-H3-Image a https://apimaster.ai/v1. Para una alternativa con descuento y un contrato de facturación diferente, compare las rutas de Nano Banana 2.1, actualmente hasta 55% por debajo de la referencia de salida de imagen de Google.