MiniMax H3-Image умеет генерировать изображения уровня 4096 × 4096: по графику задержек MiniMax, медианная задержка Highspeed составляет 10,3 секунды, Standard — 16,0 секунды. Для обычного text-to-image в 4K примерная цена Standard ($0.06879) ниже, чем у указанного в статье стороннего хостинга (WaveSpeed: $0.03 за изображение в 1K/2K и $0.09 в 4K). Highspeed, напротив, дороже — $0.13001. Но если вам важна стабильная идентичность при работе с несколькими референсами, отзывы пользователей советуют смотреть в другую сторону.
4K примерно за 10 секунд — но с редактированием пока есть вопросы
H3-Image — новая модель изображений с открытыми весами, созданная на базе видеомодели MiniMax H3. Она поддерживает text-to-image, генерацию по референсам и редактирование: до 16 референсных картинок и до 10 результатов за один запрос. Уровни площади 1K/2K/4K рассчитаны на 1,048,576 / 4,194,304 / 16,777,216 пикселей. Точные ширину и высоту сервер подбирает из соотношения сторон и возвращает в data[].size. Поэтому 4K — это целевая площадь, а не обязательно квадрат ровно 4096×4096.
MiniMax приводит хорошие показатели P50, хотя сравнение в 4K довольно узкое. В графике P50 от MiniMax для Highspeed text-to-image указаны 7,7 с на 1K и 10,3 с на 4K; у Standard — 10,6 с и 16,0 с соответственно. В 4K сравнение приведено лишь с Nano Banana 2.1, которому требуется 50–51 с. Поэтому заявление «в 5 раз быстрее массовых решений» опирается на весьма ограниченную выборку.
В связанных обсуждениях Reddit пользователи подтверждают высокую скорость T2I, но регулярно отмечают две проблемы: потерю сходства с референсами и мягкие детали при заявленном высоком разрешении.
«К сожалению, как ref2i-модель она намного хуже настоящей H3 video для ref2i». — u/Omegapepper в r/StableDiffusion
«Кому-то это может не понравиться, но по моим тестам она заметно уступает QI 2.1 [...] в редактировании с несколькими референсами». — u/Crazy-Repeat-2006 в r/StableDiffusion
В связанном треде о рекомендуемых размерах тестировщики пишут о мягкости и размытии в результатах низкого разрешения, которые должны быть резкими. Также обсуждается, содержит ли заявленное высокое разрешение реальные высокочастотные детали. Это ранние субъективные отзывы, а не контролируемый бенчмарк, но все они указывают в одном направлении.
Что предлагает API: две модели, два эндпоинта и расширение промпта
В документации MiniMax API указаны два ID моделей, два эндпоинта для изображений и отдельный шаг расширения промпта.
| Параметр | MiniMax-H3-Image (Standard) | MiniMax-H3-Image-Highspeed |
|---|---|---|
| Задача | Минимальная стоимость изображения | Минимальная задержка |
| Входной текст | $2.30 / 1M токенов | $2.30 / 1M токенов |
| Входное изображение | $1.50 / 1M токенов | $3.00 / 1M токенов |
| Выходное изображение | $3.80 / 1M токенов | $7.60 / 1M токенов |
Эндпоинты ниже приведены для Global host; аккаунты из Китая используют китайский эндпоинт из той же документации:
POST https://api.minimax.io/v1/images/generations— text-to-image. Среди подтверждённых параметров:model,prompt(до 32 000 символов),disable_prompt_enhanced(по умолчанию false),n(1–10),size(autoилиWIDTHxHEIGHT),aspect_ratio,area(1K/2K/4K, по умолчанию4K),output_format(по умолчанию jpeg),response_format(url/b64_json),stream,output_compression.POST /v1/images/edits— редактирование с 1–16 референсами. Принимаются JPG/PNG/WebP/HEIC/HEIF с размером стороны от 128 до 8192 px.H3-Image-Context-IR— этап расширения промпта, а не эндпоинт генерации изображений: он переписывает короткий промпт и выбирает соотношение сторон.
Готовая к копированию команда для Global host:
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"}'Документация отдельно предупреждает: запросы неидемпотентны, сервер может обрабатывать их до 600 секунд, а генерация продолжится даже после тайм-аута или отключения клиента. Готовое изображение в таком случае всё равно будет списано, при этом оплачиваются только успешные результаты — usage учитывает именно их. Для OpenAI SDK MiniMax рекомендует max_retries=0. При частичном успехе API вернёт HTTP 200, но отдельные элементы data[].error могут содержать ошибки, включая срабатывания контентной модерации. Проверять нужно каждый элемент: 4xx/5xx возвращаются только когда не удалась вся пачка. Большинство 4xx стоит считать окончательными ошибками конфигурации, а при неоднозначном тайм-ауте не следует отправлять запрос повторно. У асинхронных провайдеров вместо нового запроса опрашивайте уже созданную задачу.
Расширение промпта включено по умолчанию. В text-to-image его можно отключить, но для редактирования такой опции нет; переписанный вариант API возвращает в data[].revised_prompt. Логируйте его и сравнивайте с исходным промптом, прежде чем настраивать что-либо ещё. У отключённого расширителя есть ограничения: модель читает примерно первые 4,096 токенов, а вам нужно явно задать точный размер либо соотношение сторон.
Локальный запуск: не 10 секунд, а большие веса, VRAM и лицензия
Веса доступны на Hugging Face MiniMaxAI/MiniMax-H3-Image и GitHub MiniMax-AI/MiniMax-H3-Image. Есть конвертированные веса для ComfyUI и шаблон workflow image_minimax_h3_image_t2i.json. В карточке модели указаны diffusion transformer на 33.1B параметров, BF16-чекпойнт размером 68.65 GB и отдельный текстовый энкодер H3 на 66.7 GB — около 135 GB ещё до необязательного prompt-expander на 17.9 GB. Для локального сервера карточка фиксирует 6 шагов инференса и guidance scale 1: другие значения там возвращают HTTP 400. Negative prompt также не поддерживается.
Не стоит рассчитывать на 10 секунд на игровой видеокарте. В обсуждениях ComfyUI спрашивают, поместится ли модель в 5090 даже при 4-битном квантовании. В связанном треде об открытых весах владелец RTX 5090 сообщает примерно о 21 секунде на 16 MP в INT8: результат получается зернистым, а для резкости нужен BF16, который работает дольше. Пользователь RTX 3070 Ti в треде ComfyUI называет T2I быстрым для результата в 16 MP, но отмечает, что редактирование по референсу проигнорировало промпт. Это единичное наблюдение, а не доказательство того, что агрессивное квантование безопасно для работы с референсами.
Для многих команд лицензия важнее объёма VRAM. В карточке модели используется MiniMax-H3-Image Community License Agreement от November 10, 2026. Базовая лицензия исключает Соединённые Штаты, Европейский союз, Великобританию и Республику Корея; при годовой выручке выше $1M, а также для хостинговых сервисов для третьих лиц, требуется предварительное письменное разрешение. Коммерческие интерфейсы обязаны отображать «MiniMax-H3-Image». Командам из США и ЕС стоит урегулировать лицензионный вопрос до самостоятельного хостинга.
Сколько стоят изображения 1K, 2K и 4K: расчёты MiniMax
Все цифры ниже — это примеры стоимости от MiniMax, а не фиксированные тарифы. Биллинг идёт по токенам, поэтому итог зависит от длины промпта и числа референсов. В примерах с референсами предполагаются референсные изображения 1K.
| Задача | Пример Standard | Пример Highspeed |
|---|---|---|
| T2I, площадь 1K | $0.02179 | $0.03529 |
| T2I, площадь 2K | $0.02333 | $0.03622 |
| T2I, площадь 4K | $0.06879 ($0.03439 promo) | $0.13001 ($0.06501 promo) |
| Редактирование 4K + 1 референс | $0.07312 ($0.03656 promo) | $0.13673 ($0.06837 promo) |
| Редактирование 4K + 3 референса | $0.07914 ($0.03957 promo) | $0.15407 ($0.07703 promo) |
Экономить помогают три вещи. Во-первых, 2K стоит почти столько же, сколько 1K ($0.02333 против $0.02179), но даёт в 4 раза больше целевых пикселей — если подходят оба варианта, выбирайте 2K. Во-вторых, в 4K в 16 раз больше пикселей, чем в 1K, при примерной цене выше лишь в 3.2 раза, так что нативный 4K выгоден, когда нужна детализация для печати. В-третьих, стартовая акция снижает стоимость подходящих 4K-результатов Standard вдвое, до $0.03439, до November 17, 2026 at 16:00 UTC — для изображений минимум с 16,600,000 пикселей.
Highspeed примерно удваивает тарифы на токены изображений ради экономии 3–7 секунд. Для T2I в 4K это $0.13001 против $0.06879, то есть в 1.89 раза дороже. Если вы не рендерите каталоги пакетно под жёсткий latency SLO, выгоднее Standard. Каждый дополнительный референс добавляет токены входного изображения: редактирование 4K с 3 референсами примерно на 8% дороже, чем с одним, ещё до оценки качества.
Куда отправлять API-вызов: H3-Image, Qwen, Krea или H3 video?
Для массового text-to-image в высоком разрешении H3-Image выглядит привлекательно по опубликованным MiniMax примерам цены и задержек. Если ключевая задача — сохранение идентичности, до внедрения стоит протестировать альтернативы ниже.
| Сценарий | Выбор | Почему |
|---|---|---|
| Массовый T2I: постеры, фоны, 4K-пейзажи | H3-Image Standard | Примеры: $0.023 за 2K и $0.069 за 4K; самый быстрый 4K на графике MiniMax |
| Пакетная работа с чувствительностью к задержке: реклама, live preview | H3-Image Highspeed | От 7.7 с на 1K до 10.3 с на 4K; доплата в 1.9 раза экономит около 6 с |
| Согласованность персонажа или товара по нескольким референсам | Qwen Image через Alibaba Cloud или H3 video ref2i | В связанных тредах H3-Image называют слабее QI 2.1 для multi-ref-редактирования; несколько пользователей оставляют H3 video для ref2i |
| Управляемый UI для редактирования вместо API или самостоятельного хостинга | Krea | Не нужен локальный объём около 135 GB; это UI-альтернатива, а не аналог API |
| Самостоятельный хостинг на 24GB или меньше | Подождать pruned/INT4-сборок | Сегодня BF16 требует VRAM уровня дата-центра |
Когда критично сходство с референсом, более низкая примерная цена одного изображения быстро теряется на повторных попытках.
Чек-лист перед запуском, чтобы не платить за размытые результаты
- Начните с пресетов 1K/2K и переходите на 4K только для удачных кадров. Тестировщики сообщают о мягком дефолтном 4K, поэтому сначала проверьте резкость на 2K.
- На каждом запуске логируйте
revised_promptи сравнивайте его с отправленным промптом, прежде чем менять другие настройки. - Задавайте клиентские тайм-ауты выше 600 с, поскольку сервер может работать до 600 с; отключите автоматические повторы SDK, ведите клиентский dedupe key только для сверки, а у асинхронных провайдеров опрашивайте задачу вместо повторного POST.
- Обрабатывайте отдельные
data[].errorвнутри HTTP 200 для пакетов с несколькими результатами. До написания цикла изучите формат ошибок в справке по edits. - Проверьте лицензию,
response_formatи скачивание промптов: согласно документации API, ответы в форматеurlне гарантируют долговременное хранение.
FAQ по MiniMax H3-Image API
Чем MiniMax H3-Image отличается от MiniMax H3?
H3 — видеомодель, а H3-Image — построенная на её базе модель статичных изображений для text-to-image и редактирования на площадях уровня 4K. Для стабильности reference-to-image несколько пользователей в связанных тредах по-прежнему предпочитают H3 video.
Какой официальный endpoint и model ID?
POST https://api.minimax.io/v1/images/generations с model: MiniMax-H3-Image или MiniMax-H3-Image-Highspeed, а также /v1/images/edits и H3-Image-Context-IR для расширения промпта.
Можно ли отключить расширение промпта?
Для text-to-image — да, через disable_prompt_enhanced: true; для редактирования — нет. API возвращает фактически использованный переписанный промпт.
Можно ли запустить H3-Image локально на потребительской GPU?
Только с квантованием и запасом терпения: в BF16 требуется около 135 GB ещё до prompt-expander. В карточке модели для серверных конфигураций названы ускорители уровня H200, RTX PRO 6000 и MI350X.
Разрешено ли коммерческое использование?
Только после урегулирования условий MiniMax-H3-Image Community License: базовая лицензия исключает США, ЕС, Великобританию и Корею, а при выручке выше $1M или для хостинговых сервисов третьих лиц требуется разрешение.