# MiniMax H3 Image

> MiniMax H3 Image (официальный ID MiniMax-H3-Image, имя в RouteMux minimax/minimax-h3-image) — модель генерации и редактирования изображений от MiniMax. Она поддерживает генерацию по тексту и редактирование с использованием от 1 до 16 референсных изображений, три уровня разрешения 1K, 2K и 4K (до ~16 мегапикселей) или пользовательский размер в пикселях, создание от 1 до 10 изображений за запрос и тарификацию за входные и выходные токены. В этой же линейке представлена высокоскоростная версия minimax/minimax-h3-image-highspeed: оба варианта имеют одинаковые эндпоинты, параметры и ограничения; стандартная модель используется по умолчанию для повседневных и пакетных задач, а Highspeed работает быстрее и снижает задержку.

Canonical: https://routemux.com/ru/minimax/minimax-h3-image
Provider: MiniMax

## Key facts

| Field | Value |
| --- | --- |
| Model ID | minimax/minimax-h3-image |
| Official model ID | MiniMax-H3-Image |
| Input modalities | text, image |
| Output modalities | image |
| Capabilities | Image Generation, Image Edit |
| Upstream release | 2026-11-10 |
| Availability | available |

## Pricing

- RouteMux: $1.9 per 1M tokens
- Official: $3.8 per 1M tokens
- Saving vs official: 50%
- Official price source: https://platform.minimax.io/docs/pricing/overview, verified 2026-11-11

Billing is prepaid wallet, charged per successful request only.

## API access

Base URL: https://api.routemux.com

Supported protocols:

- openai_images

## What is MiniMax H3 Image

MiniMax H3 Image (официальный ID MiniMax-H3-Image, имя в RouteMux minimax/minimax-h3-image) — модель генерации и редактирования изображений от MiniMax. Она поддерживает генерацию по тексту и редактирование с использованием от 1 до 16 референсных изображений, три уровня разрешения 1K, 2K и 4K (до ~16 мегапикселей) или пользовательский размер в пикселях, создание от 1 до 10 изображений за запрос и тарификацию за входные и выходные токены. В этой же линейке представлена высокоскоростная версия minimax/minimax-h3-image-highspeed: оба варианта имеют одинаковые эндпоинты, параметры и ограничения; стандартная модель используется по умолчанию для повседневных и пакетных задач, а Highspeed работает быстрее и снижает задержку.

На RouteMux модель вызывается через совместимый протокол OpenAI Images: для генерации по тексту отправляйте POST https://api.routemux.com/v1/images/generations, а для редактирования — POST https://api.routemux.com/v1/images/edits. Длина prompt — до 32000 символов Unicode, за один запрос можно создать от n=1 до 10 изображений. При редактировании поддерживается передача от 1 до 16 референсных изображений через JSON-массив images (каждый элемент содержит поле image_url) или multipart-загрузку в полях image и image[]; локальная маска (mask) и потоковая передача (stream может быть только опущен или равен false) не поддерживаются.

Задать размер и пропорции можно двумя способами: указать уровень разрешения area ("1K", "2K" или "4K", по умолчанию "4K") вместе с aspect_ratio ("auto" или X:Y, где X и Y — целые числа от 1 до 300, а отношение сторон лежит в диапазоне от 1:3 до 3:1, например 1:1, 16:9, 9:16, 21:9, 3:1, 1:3), либо передать точный размер в пикселях через size (WxH с площадью от 655360 до 20000000 пикселей и отношением сторон от 1:3 до 3:1; при указании WxH поля aspect_ratio и area нужно опустить; size также принимает "auto"). Автоматическое расширение промпта по умолчанию включено; если при генерации по тексту установить disable_prompt_enhanced в true, необходимо явно задать size в формате WxH или aspect_ratio в формате X:Y (в режиме редактирования расширение промпта включено всегда, и передача disable_prompt_enhanced=true не поддерживается). Формат файла задаётся через output_format ("png", "jpeg", "jpg", "webp"), а формат ответа — через response_format ("url" или "b64_json"). Параметр output_compression принимает целое число от 0 до 100 (по умолчанию 95) и действует только для jpeg и webp. Референсы в image_url должны быть публичными https-ссылками или data URL; ссылки mm_file:// не поддерживаются.

Поскольку генерация изображений неидемпотентна (non_idempotent), при обрыве соединения или клиентском таймауте апстрим продолжает генерацию и списывает токены, а повторная отправка приведёт к дублированию генерации и двойной оплате. Шлюз RouteMux для этой модели повторяет запрос только при ответе HTTP 429 от апстрима и никогда не повторяет при 5xx, таймаутах и сетевых ошибках; на стороне клиента установите max_retries=0 в OpenAI SDK (или maxRetries: 0 в TypeScript) и не используйте --retry в curl.

## Key capabilities

- **1K/2K/4K и гибкие пропорции** — Поддержка уровней area 1K/2K/4K (до ~16 МП) или точного размера size (от 655 тыс. до 20 млн пикселей) с соотношением сторон от 1:3 до 3:1.
- **Редактирование по 1–16 референсам** — Передавайте от 1 до 16 референсных изображений в /v1/images/edits; генерация и редактирование поддерживают от 1 до 10 картинок за вызов.
- **Защита от повторного списания** — Шлюз повторяет запрос только при ответе 429 от апстрима и не повторяет при 5xx, таймаутах и сетевых ошибках; в SDK задайте max_retries=0 (или maxRetries: 0).
- **Дешевле официальной цены на 50%** — Тарификация за входные текстовые, входные графические и выходные токены на RouteMux со скидкой 50% относительно официального прайса MiniMax.

## Use cases

- **Генерация графических материалов высокого разрешения** — Используйте уровни area 1K/2K/4K (~16 МП) или точные пиксельные размеры WxH с пропорциями от 1:3 до 3:1 и промптами до 32000 символов для создания материалов разных форматов.
- **Согласованное редактирование по нескольким референсам** — Передавайте от 1 до 16 референсных изображений в /v1/images/edits и задавайте n=1..10 для пакетного редактирования с сохранением единства объектов.

## Other variants in this family

- MiniMax H3 Image Highspeed (`minimax/minimax-h3-image-highspeed`)

## Sources

- [Документация MiniMax по генерации изображений](https://platform.minimax.io/docs/guides/image-generation)
- [Обзор цен MiniMax](https://platform.minimax.io/docs/pricing/overview)