Цена для ранних подписчиков (до 25 декабря) сохраняется, пока подписка активна: Go за $10/мес. (обычно $20), Plus с Opus 5.5 всего за $30/мес. (обычно $50)Оформить подписку →

MiniMax H3-Image API: цена 4K, лимиты и VRAM (2026)

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; аккаунты из Китая используют китайский эндпоинт из той же документации:

  1. 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.
  2. POST /v1/images/edits — редактирование с 1–16 референсами. Принимаются JPG/PNG/WebP/HEIC/HEIF с размером стороны от 128 до 8192 px.
  3. H3-Image-Context-IR — этап расширения промпта, а не эндпоинт генерации изображений: он переписывает короткий промпт и выбирает соотношение сторон.

Готовая к копированию команда для Global host:

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"}'

Документация отдельно предупреждает: запросы неидемпотентны, сервер может обрабатывать их до 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 previewH3-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 или для хостинговых сервисов третьих лиц требуется разрешение.