MiniMax H3 Image API — text-to-image and editing with up to 16 reference images, 1K to 4K
minimax-h3-imageMiniMax H3 Image — модель генерации изображений от MiniMax; на apimodels.app она вызывается одним API-ключом под именем minimax-h3-image (написание MiniMax-H3-Image тоже принимается). Одна модель и рисует по тексту, и редактирует: отправьте только промпт — получите генерацию по тексту; добавьте от 1 до 16 референсов, на которые в промпте можно ссылаться как «изображение 1», «изображение 2» и так далее, — и модель изменит часть фото, сменит стиль или соберёт одну картинку из нескольких. За один запрос — от 1 до 10 изображений. Размер задаётся одним из двух способов: уровнем площади 1K, 2K или 4K (по умолчанию 2K) вместе с auto или любым соотношением сторон от 1:3 до 3:1 либо точным размером от 655 360 до 20 000 000 пикселей. По умолчанию — JPEG, по запросу PNG или WebP. Промпты для генерации по тексту проходят через встроенное улучшение промпта; отключить его можно параметром disable_prompt_enhanced, а при редактировании оно работает всегда. В наших тестах генерация 1K 16:9 по тексту заняла около 10 секунд и вернула 1360×768, а правка 1K с одним референсом — около 16 секунд. Цена: $0.03 за изображение в 1K или 2K и $0.10 в 4K (свой размер больше примерно 5 мегапикселей считается как 4K), плюс $0.01 за каждый референс; оплачиваются только реально полученные изображения, неудачный запрос ничего не стоит. Референсы крупнее примерно 2,4 мегапикселя перед отправкой пропорционально уменьшаются. Успешен не каждый запрос: модерация может отклонить промпт или изображение. Маски, прозрачный фон, negative_prompt и seed не поддерживаются — такие запросы получают ответ 400, а не молча игнорируются. Если важнее скорость, есть minimax-h3-image-highspeed: он быстрее, но стоит больше.
Generate Image
Result
Generated image will appear here
Enter a prompt and click Generate
Генерация и правка в одной модели
Только промпт — картинка по тексту; промпт и 1–16 референсов (в промпте — image 1, image 2…) — правка части фото, смена стиля или сборка нескольких картинок в одну
1K, 2K или 4K, пропорции от 1:3 до 3:1
Уровень площади (по умолчанию 2K) с auto или любым X:Y — либо точный размер от 655,360 до 20,000,000 пикселей. На выходе JPEG, PNG или WebP
1–10 изображений за запрос
n до 10, все приходят в одном ответе; оплачиваются только реально полученные изображения
$0.03 / $0.10 за изображение
1K или 2K — $0.03, 4K — $0.10 (свой размер больше примерно 5 MP считается как 4K), плюс $0.01 за каждый референс
Ограничения
Нет масок, прозрачного фона, negative prompt и seed — вместо молчаливого игнорирования они дают 400. До 16 референсов, у каждого 128–8192 px по стороне и вытянутость не больше 4:1; всё, что больше примерно 2.4 MP, перед отправкой уменьшается
Не 100%, но неудачи бесплатны
Не каждый запрос проходит: модерация может отклонить промпт или изображение. Неудачный запрос возвращает причину и ничего не стоит
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" } }О модели MiniMax H3 Image
MiniMax H3 Image — это API категории «генерация изображений» от MiniMax. MiniMax H3 Image — модель генерации изображений от MiniMax; на apimodels.app она вызывается одним API-ключом под именем minimax-h3-image (написание MiniMax-H3-Image тоже принимается). Одна модель и рисует по тексту, и редактирует: отправьте только промпт — получите генерацию по тексту; добавьте от 1 до 16 референсов, на которые в промпте можно ссылаться как «изображение 1», «изображение 2» и так далее, — и модель изменит часть фото, сменит стиль или соберёт одну картинку из нескольких. За один запрос — от 1 до 10 изображений. Размер задаётся одним из двух способов: уровнем площади 1K, 2K или 4K (по умолчанию 2K) вместе с auto или любым соотношением сторон от 1:3 до 3:1 либо точным размером от 655 360 до 20 000 000 пикселей. По умолчанию — JPEG, по запросу PNG или WebP. Промпты для генерации по тексту проходят через встроенное улучшение промпта; отключить его можно параметром disable_prompt_enhanced, а при редактировании оно работает всегда. В наших тестах генерация 1K 16:9 по тексту заняла около 10 секунд и вернула 1360×768, а правка 1K с одним референсом — около 16 секунд. Цена: $0.03 за изображение в 1K или 2K и $0.10 в 4K (свой размер больше примерно 5 мегапикселей считается как 4K), плюс $0.01 за каждый референс; оплачиваются только реально полученные изображения, неудачный запрос ничего не стоит. Референсы крупнее примерно 2,4 мегапикселя перед отправкой пропорционально уменьшаются. Успешен не каждый запрос: модерация может отклонить промпт или изображение. Маски, прозрачный фон, negative_prompt и seed не поддерживаются — такие запросы получают ответ 400, а не молча игнорируются. Если важнее скорость, есть minimax-h3-image-highspeed: он быстрее, но стоит больше. Через платформу APIMODELS доступ к этой модели идёт по единому API с прозрачной оплатой по факту использования. Текущая цена: 1K: $0.03, 2K: $0.03, 4K: $0.1, Each reference image: +$0.01.
Ключевые возможности
- Генерация и правка в одной модели -- Только промпт — картинка по тексту; промпт и 1–16 референсов (в промпте — image 1, image 2…) — правка части фото, смена стиля или сборка нескольких картинок в одну
- 1K, 2K или 4K, пропорции от 1:3 до 3:1 -- Уровень площади (по умолчанию 2K) с auto или любым X:Y — либо точный размер от 655,360 до 20,000,000 пикселей. На выходе JPEG, PNG или WebP
- 1–10 изображений за запрос -- n до 10, все приходят в одном ответе; оплачиваются только реально полученные изображения
- $0.03 / $0.10 за изображение -- 1K или 2K — $0.03, 4K — $0.10 (свой размер больше примерно 5 MP считается как 4K), плюс $0.01 за каждый референс
- Ограничения -- Нет масок, прозрачного фона, negative prompt и seed — вместо молчаливого игнорирования они дают 400. До 16 референсов, у каждого 128–8192 px по стороне и вытянутость не больше 4:1; всё, что больше примерно 2.4 MP, перед отправкой уменьшается
- Не 100%, но неудачи бесплатны -- Не каждый запрос проходит: модерация может отклонить промпт или изображение. Неудачный запрос возвращает причину и ничего не стоит
Примеры по сценариям
Сценарии использования
Карточки товаров для e-commerce
Качественные изображения товаров для интернет-магазинов, рекламы и маркетинговых материалов.
Контент для соцсетей
Заметные визуалы для соцсетей, которые повышают вовлечённость и узнаваемость бренда.
Ассеты для игр
Концепт-арт персонажей, локаций и предметов, чтобы ускорить разработку игры.
Маркетинговые материалы
Постеры, баннеры и промо-графика за долю стоимости обычного дизайна.
Почему APIMODELS
- Единый API — один ключ на все модели, не нужно регистрироваться на нескольких площадках
- Прозрачные цены — оплата по факту использования, стоимость вызова указана на странице каждой модели; удобно независимым разработчикам и небольшим командам
- Доступ сразу — можно начинать сразу после регистрации; оплата картой, через PayPal, Alipay или в USDT
- Полная документация — подробная документация API с примерами на cURL, Python и Node.js
Частые вопросы
Чем APIMODELS отличается от официального API MiniMax?
APIMODELS отдаёт ту же самую модель MiniMax H3 Image через свою агрегирующую платформу. Мы предоставляем единый интерфейс API, поэтому отдельные аккаунты у каждого поставщика не нужны — один ключ открывает доступ ко всем моделям.
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.
Как выбрать между MiniMax H3 Image и другими моделями того же типа?
В APIMODELS MiniMax H3 Image соседствует более чем с 60 моделями под одним API-ключом и общим балансом, поэтому выбор — это вопрос соответствия задаче, а не привязки к поставщику. Модель поддерживает 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; вы можете сравнить её по цене и возможностям с другими моделями того же типа (генерация изображений) и переключиться, изменив одну строку с именем модели — без нового аккаунта и без переписывания интеграции. Все модели этого типа с актуальными ценами — на apimodels.app/models.
Что умеет MiniMax H3 Image?
MiniMax H3 Image поддерживает: 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. Полный список параметров и примеры вызовов — в документации APIMODELS.
Можно ли пользоваться API MiniMax H3 Image из России?
Со своей стороны APIMODELS не ограничивает доступ по странам: сайт и API принимают запросы откуда угодно, в том числе из России. MiniMax H3 Image вызывается одним ключом APIMODELS, отдельный аккаунт у разработчика модели не нужен. Пополнить баланс можно в USDT, через PayPal или международной картой — подробности в вопросе об оплате.
Как оплатить MiniMax H3 Image из России? Какие способы оплаты есть?
Баланс ведётся в долларах США. Пополнить его можно в USDT в сетях TRON (TRC20) или BNB Smart Chain (BEP20), через PayPal, международной картой Visa, Mastercard и других систем (через Stripe) или через Alipay. Карта, PayPal и Alipay зачисляются сразу, USDT — после подтверждения перевода в сети. Можно включить автопополнение. За пополнение на $50 начисляем бонус $1, на $100 — $3. Подписки нет, списание идёт по факту использования.