MiniMax H3 Image API — text-to-image and editing with up to 16 reference images, 1K to 4K
minimax-h3-imageMiniMax H3 Image es el modelo de generación de imágenes de MiniMax, disponible en apimodels.app como minimax-h3-image con una sola API key (también se acepta la forma MiniMax-H3-Image). El mismo modelo crea imágenes desde texto y las edita: con un prompt solo, genera; si añades de 1 a 16 imágenes de referencia, a las que el prompt puede llamar imagen 1, imagen 2 y así sucesivamente, cambia una parte de una foto, le da otro estilo o combina varias imágenes en una. Cada petición devuelve de 1 a 10 imágenes. El tamaño se fija de una de dos formas: con un nivel de área, 1K, 2K o 4K (2K por defecto), junto con auto o cualquier proporción entre 1:3 y 3:1, o con un tamaño exacto de entre 655.360 y 20.000.000 píxeles. La salida es JPEG por defecto, y PNG o WebP si los pides. En texto a imagen, el prompt pasa por la mejora automática de prompts del modelo salvo que la desactives con disable_prompt_enhanced; en las ediciones siempre está activa. En nuestras pruebas, una petición de texto a imagen en 1K y 16:9 tardó unos 10 segundos y devolvió 1360×768, y una edición en 1K con una imagen de referencia, unos 16 segundos. Precio: $0.03 por imagen en 1K o 2K y $0.10 en 4K (los tamaños personalizados de más de unos 5 megapíxeles cuentan como 4K), más $0.01 por imagen de referencia; solo se cobran las imágenes entregadas, y una petición que falla no cuesta nada. Las referencias de más de unos 2,4 megapíxeles se reducen de forma proporcional antes de enviarse. No todas las peticiones salen bien: la moderación de contenido puede rechazar un prompt o una imagen. Las máscaras, los fondos transparentes, negative_prompt y seed no están disponibles y devuelven un 400 en lugar de ignorarse en silencio. Si necesitas más velocidad a un precio mayor, usa minimax-h3-image-highspeed.
Generate Image
Result
Generated image will appear here
Enter a prompt and click Generate
Crear y editar con un solo modelo
Solo un prompt para generar desde texto, o un prompt con 1–16 imágenes de referencia (image 1, image 2… en el prompt) para retocar parte de una foto, cambiarle el estilo o juntar varias en una
1K, 2K o 4K, proporciones de 1:3 a 3:1
Eliges un nivel de área (2K por defecto) con auto o cualquier proporción X:Y, o pasas un tamaño exacto entre 655,360 y 20,000,000 píxeles. Salida en JPEG, PNG o WebP
1–10 imágenes por petición
Con n hasta 10 recibes todas en la misma respuesta; solo pagas las imágenes que llegan
$0.03 / $0.10 por imagen
1K o 2K a $0.03 y 4K a $0.10 (los tamaños propios de más de unos 5 MP cuentan como 4K), más $0.01 por cada imagen de referencia
Límites
Sin máscaras, fondos transparentes, negative prompts ni seed: devuelven un 400 en lugar de ignorarse. Hasta 16 imágenes de referencia, de 128–8192 px por lado y como mucho 4:1; las que superan unos 2.4 MP se reducen antes de enviarse
No acierta el 100%, pero los fallos no se cobran
No todas las peticiones salen bien: la revisión de contenido puede rechazar un prompt o una imagen. Una petición fallida devuelve el motivo y no cuesta nada
MiniMax H3 Image API: text-to-image and editing with up to 16 reference images, 1K to 4K
MiniMax H3 Image is MiniMax's image generation model. Send a prompt and get 1 to 10 images, or add up to 16 reference images to change part of a photo, restyle it or combine several pictures into one. Sizes run from 1K to 4K in any shape from 1:3 to 3:1.
On APIMODELS it is one model id, minimax-h3-image, on POST /v1/images/generations: $0.03 per image at 1K or 2K, $0.10 at 4K, plus $0.01 per reference image. It has no masks, no transparent background and no seed, and not every request succeeds; the limits are listed below.
- Model ID
minimax-h3-image- Input
- Text prompt, plus up to 16 reference images (optional)
- Output
- 1–10 images, 1K / 2K / 4K (default 2K)
- Aspect ratio
- auto or any ratio from 1:3 to 3:1
- Price
- $0.03 (1K / 2K), $0.10 (4K), +$0.01 per reference
MiniMax H3 Image API limits at a glance
What the model accepts and what it does not. Unsupported inputs return a 400 before anything is generated, instead of being silently ignored, so you never pay for an image that skipped part of your request.
| Supported | Not supported | |
|---|---|---|
| Input | A text prompt of up to 32,000 characters, alone or with 1 to 16 reference images for editing, restyling or combining pictures (image 1, image 2… in the prompt) | Masks (inpainting) |
| Reference images | 1 to 16 (+$0.01 each), as public URLs or base64 data URIs; each 128–8192 px per side, the long side at most 4× the short side, up to 64 MB. Anything above about 2.4 MP is scaled down before it is sent | More than 16; images outside those sizes (400) |
| Images per request | 1 to 10 (n); only images actually delivered are charged | n above 10 (400) |
| Size | resolution 1K, 2K or 4K (2K by default) with aspect_ratio auto or any X:Y from 1:3 to 3:1; or an exact size WIDTHxHEIGHT between 655,360 and 20,000,000 pixels | Shapes beyond 1:3 or 3:1; exact sizes outside that pixel range (400) |
| Output format | JPEG by default; PNG or WebP with output_format | Transparent background (background: transparent returns 400) |
| Prompt enhancement | On by default. For text-to-image, disable_prompt_enhanced: true turns it off when you also set aspect_ratio or size | Turning it off for edits (edits always use it) |
| Other controls | aigc_watermark (true / false) | negative_prompt and seed (400; results are not repeatable) |
Not every MiniMax H3 Image request succeeds
Like every image model, it does not succeed 100% of the time. You are charged only for images that are delivered.
A request can fail after it is accepted: content review can refuse the prompt or a reference image, and a generation can hit a temporary error. A failed request returns the reason and costs nothing. When you ask for several images and only some come back, you pay only for those.
Our five test requests on 11 November 2026 all returned images, which is far too few to promise a success rate, so we do not publish one. At 1K they took 6 to 16 seconds; 4K, several images per request and many reference images take longer, so give the call a generous timeout. Build in retries for temporary errors and rewrite refused prompts.
MiniMax H3 Image API pricing
Per output image by size tier, plus a fixed amount per reference image. The text prompt is free.
| minimax-h3-image | minimax-h3-image-highspeed | |
|---|---|---|
| Each output image · 1K or 2K | $0.03 | $0.05 |
| Each output image · 4K | $0.10 | $0.18 |
| Each reference image | +$0.01 | +$0.015 |
| Exact size (size WIDTHxHEIGHT) | Up to 5,033,165 pixels at the 1K / 2K price, above that at the 4K price | Same rule |
2K text-to-image, 1 image
$0.03
1 × $0.03
2K edit with 2 reference images, 1 image
$0.05
$0.03 + 2 × $0.01
4 variations at 2K in one request
$0.12
4 × $0.03; if only 3 come back, $0.09
4K poster, 1 image
$0.10
1 × $0.10
Standard or Highspeed?
Both tiers take exactly the same request: the same fields, the same limits and the same responses. Only the model id, the speed and the price differ, so you can switch with one string.
| minimax-h3-image | minimax-h3-image-highspeed | |
|---|---|---|
| Our 1K 16:9 test (one request each) | Text-to-image about 10 s; edit with one reference about 16 s | Poster with two text lines about 6 s |
| 1K / 2K · 4K · each reference | $0.03 · $0.10 · +$0.01 | $0.05 · $0.18 · +$0.015 |
| Use it for | Batch jobs and pipelines where nobody is waiting on the picture | Interactive apps where a user is waiting for the result |
When MiniMax H3 Image is a good fit, and when it is not
Edits that pull from many pictures
Up to 16 reference images in one request: a product, a model, a background and a style board, referred to as image 1, image 2 and so on.
Several variations at once
n up to 10 in one call, and only the images that come back are charged.
Large sizes and wide shapes
4K, or an exact size up to 20 megapixels, in any shape from 1:3 to 3:1.
Masked inpainting
There are no masks. Describe the change in the prompt and pass the picture as a reference image instead.
Transparent assets
No transparent background. For PNGs with a real alpha channel, use doubao-seedream-5-5 with background: "transparent".
Repeatable results
There is no seed, so the same request returns a different picture each time.
Call it in one request
POST /v1/images/generations with your apimodels.app API key. By default you get a taskId back and poll GET /v1/images/generations?task_id= (or pass a callback_url); with a WIDTHxHEIGHT size or the OpenAI SDK, the images come back in the same response. Full field list in the docs.
curl -X POST https://api.apimodels.app/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "Replace the croissant on the plate with a slice of strawberry cheesecake. Keep the cup, saucer, latte art, steam, table, window light and everything else exactly the same.",
"image": "https://example.com/cafe.jpg",
"resolution": "2K",
"aspect_ratio": "16:9"
}'
# → { "code": 200, "data": { "taskId": "...", "state": "pending", "model": "minimax-h3-image" } }Acerca de MiniMax H3 Image
MiniMax H3 Image es una API de generación de imágenes de MiniMax. MiniMax H3 Image es el modelo de generación de imágenes de MiniMax, disponible en apimodels.app como minimax-h3-image con una sola API key (también se acepta la forma MiniMax-H3-Image). El mismo modelo crea imágenes desde texto y las edita: con un prompt solo, genera; si añades de 1 a 16 imágenes de referencia, a las que el prompt puede llamar imagen 1, imagen 2 y así sucesivamente, cambia una parte de una foto, le da otro estilo o combina varias imágenes en una. Cada petición devuelve de 1 a 10 imágenes. El tamaño se fija de una de dos formas: con un nivel de área, 1K, 2K o 4K (2K por defecto), junto con auto o cualquier proporción entre 1:3 y 3:1, o con un tamaño exacto de entre 655.360 y 20.000.000 píxeles. La salida es JPEG por defecto, y PNG o WebP si los pides. En texto a imagen, el prompt pasa por la mejora automática de prompts del modelo salvo que la desactives con disable_prompt_enhanced; en las ediciones siempre está activa. En nuestras pruebas, una petición de texto a imagen en 1K y 16:9 tardó unos 10 segundos y devolvió 1360×768, y una edición en 1K con una imagen de referencia, unos 16 segundos. Precio: $0.03 por imagen en 1K o 2K y $0.10 en 4K (los tamaños personalizados de más de unos 5 megapíxeles cuentan como 4K), más $0.01 por imagen de referencia; solo se cobran las imágenes entregadas, y una petición que falla no cuesta nada. Las referencias de más de unos 2,4 megapíxeles se reducen de forma proporcional antes de enviarse. No todas las peticiones salen bien: la moderación de contenido puede rechazar un prompt o una imagen. Las máscaras, los fondos transparentes, negative_prompt y seed no están disponibles y devuelven un 400 en lugar de ignorarse en silencio. Si necesitas más velocidad a un precio mayor, usa minimax-h3-image-highspeed. A través de la plataforma APIMODELS puedes acceder a este modelo mediante una API unificada con precios de pago por uso transparentes. Precio actual: 1K: $0.03, 2K: $0.03, 4K: $0.1, Each reference image: +$0.01.
Características principales
- Crear y editar con un solo modelo -- Solo un prompt para generar desde texto, o un prompt con 1–16 imágenes de referencia (image 1, image 2… en el prompt) para retocar parte de una foto, cambiarle el estilo o juntar varias en una
- 1K, 2K o 4K, proporciones de 1:3 a 3:1 -- Eliges un nivel de área (2K por defecto) con auto o cualquier proporción X:Y, o pasas un tamaño exacto entre 655,360 y 20,000,000 píxeles. Salida en JPEG, PNG o WebP
- 1–10 imágenes por petición -- Con n hasta 10 recibes todas en la misma respuesta; solo pagas las imágenes que llegan
- $0.03 / $0.10 por imagen -- 1K o 2K a $0.03 y 4K a $0.10 (los tamaños propios de más de unos 5 MP cuentan como 4K), más $0.01 por cada imagen de referencia
- Límites -- Sin máscaras, fondos transparentes, negative prompts ni seed: devuelven un 400 en lugar de ignorarse. Hasta 16 imágenes de referencia, de 128–8192 px por lado y como mucho 4:1; las que superan unos 2.4 MP se reducen antes de enviarse
- No acierta el 100%, pero los fallos no se cobran -- No todas las peticiones salen bien: la revisión de contenido puede rechazar un prompt o una imagen. Una petición fallida devuelve el motivo y no cuesta nada
Ejemplos por escenario
Casos de uso
Imágenes de producto para e-commerce
Genera imágenes de producto de alta calidad para tiendas online, anuncios y material de marketing.
Contenido para redes sociales
Crea contenido visual llamativo para redes sociales y aumenta la interacción y la visibilidad de marca.
Recursos para videojuegos
Produce arte conceptual de personajes, escenarios y objetos para acelerar el desarrollo de juegos.
Material de marketing
Diseña carteles, banners y gráficos promocionales a una fracción del coste tradicional.
Por qué APIMODELS
- API unificada -- Una sola clave para todos los modelos, sin registrarte en varias plataformas
- Precios transparentes -- Pago por uso con el precio por llamada publicado en cada página de modelo, ideal para desarrolladores independientes y startups
- Acceso instantáneo -- Empieza justo después de registrarte; paga con tarjeta, PayPal, Alipay o USDT
- Documentación completa -- Documentación de API detallada con ejemplos en cURL, Python y Node.js
Preguntas frecuentes
¿Cuál es la diferencia entre APIMODELS y la API oficial de MiniMax?
APIMODELS ofrece el mismo modelo MiniMax H3 Image a través de nuestra plataforma de agregación. Proporcionamos una interfaz de API unificada, así que no necesitas cuentas separadas por proveedor: una sola clave para acceder a todos los modelos.
How do I call the MiniMax H3 Image API?
Get an API key on apimodels.app and POST to /v1/images/generations with model set to minimax-h3-image (MiniMax's spelling, MiniMax-H3-Image, also works). Send no image for text-to-image, or 1 to 16 reference images (image or images, as URLs or base64) to edit or combine pictures, referring to them in the prompt as image 1, image 2 and so on. By default the call is asynchronous: it returns a taskId that you poll with GET /v1/images/generations?task_id=, or you pass a callback_url. With a WIDTHxHEIGHT size or the OpenAI SDK, the image comes back in the same response. No separate MiniMax account is needed.
How much does the MiniMax H3 Image API cost?
$0.03 per output image at 1K or 2K and $0.10 at 4K, plus $0.01 per reference image; the text prompt is free. A 2K edit with two reference images and one output costs $0.05; four 2K text-to-image outputs in one request cost $0.12. Custom sizes are priced by area: up to about 5.03 megapixels at the 2K price, above that at the 4K price. Only images actually delivered are charged, and a request that fails costs nothing.
Standard or Highspeed (minimax-h3-image-highspeed)?
Both take the same request, fields and limits; they differ in speed and price. We ran one 1K test of each: Highspeed returned a poster in about 6 seconds, the standard model a text-to-image request in about 10 seconds. Highspeed is $0.05 per image at 1K / 2K, $0.18 at 4K and $0.015 per reference image, against $0.03 / $0.10 / $0.01 for the standard model. Use the standard model for batch work that is not waiting on latency, and Highspeed when a user is waiting for the picture.
What are the limits of MiniMax H3 Image?
Prompts up to 32,000 characters; 1 to 10 images per request; up to 16 reference images, each 128 to 8192 pixels per side, the long side at most 4 times the short side and no larger than 64 MB, with anything above about 2.4 megapixels scaled down before it is sent; aspect ratios from 1:3 to 3:1; custom sizes between 655,360 and 20,000,000 pixels. Masks, transparent backgrounds, negative prompts and seeds are not supported and return a 400. Turning off prompt enhancement (disable_prompt_enhanced) works only for text-to-image and needs an aspect ratio or size alongside it.
What size do I get if I do not set one?
A 2K-area image, with the aspect ratio chosen by the model from the prompt (auto). For 1K or 4K pass resolution: "1K" or "4K"; for a fixed shape pass aspect_ratio, for example "16:9"; for exact pixels pass size, for example "2720x1536", in which case resolution and aspect_ratio no longer apply. In our test a 1K 16:9 request returned 1360×768.
What happens when a request fails?
Not every request succeeds: content review can refuse a prompt or an image, and the upstream service occasionally has temporary errors. When you ask for several images, you pay only for the ones delivered; if the whole request fails, nothing is charged and the reserved credit is returned. The response says why it failed: for a review refusal change the prompt or image, for a temporary error simply retry.
¿Cómo se compara MiniMax H3 Image con otros modelos de su categoría?
En APIMODELS, MiniMax H3 Image convive con más de 60 modelos bajo una sola clave API y un solo saldo, así que elegir es cuestión de ajuste, no de dependencia. Admite Text to Image, Image Editing · up to 16 Refs, 1K / 2K / 4K, Ratios 1:3 to 3:1, 1–10 Images per Request, $0.03–$0.10/image y puedes valorarlo en precio y capacidad frente a otros modelos de la misma categoría (generación de imágenes), y cambiar modificando una sola cadena con el nombre del modelo: sin nueva cuenta ni integración. Explora todos los modelos de esa categoría con precios en vivo en apimodels.app/models.
¿Qué puede hacer MiniMax H3 Image?
MiniMax H3 Image admite: Text to Image, Image Editing · up to 16 Refs, 1K / 2K / 4K, Ratios 1:3 to 3:1, 1–10 Images per Request, $0.03–$0.10/image. Consulta la documentación de APIMODELS para ver todos los parámetros y ejemplos de llamada.
¿Puedo usar la API de MiniMax H3 Image desde cualquier país?
Sí. APIMODELS no limita el acceso por país: la web y la API responden desde cualquier lugar, y apimodels.app y api.apimodels.app también son accesibles directamente desde China continental, sin proxy. Llamas a MiniMax H3 Image con una sola clave de APIMODELS, sin abrir una cuenta aparte con el desarrollador del modelo.
¿Puedo pagar con PayPal o cripto? ¿Qué métodos de pago hay?
Sí. Puedes recargar saldo con PayPal, USDT en TRON (TRC20) o en BNB Smart Chain (BEP20), tarjeta (Visa, Mastercard y otras, a través de Stripe) o Alipay. Las recargas con tarjeta, PayPal y Alipay se acreditan al instante; las de USDT, en cuanto la transferencia se confirma en la cadena. Puedes activar la recarga automática, y al recargar $50 sumamos $1 de bono ($3 si recargas $100). El saldo es en dólares y se cobra por uso, sin suscripción.