MiniMax H3 Image Highspeed

MiniMax H3 Image Highspeed (официальный ID MiniMax-H3-Image-Highspeed, имя в RouteMux minimax/minimax-h3-image-highspeed) — скоростная версия семейства MiniMax H3 Image с пониженной задержкой, созданная для интерактивных инструментов и быстрой итерации. Она полностью сохраняет возможности стандартной модели minimax/minimax-h3-image: генерацию по тексту в 1K, 2K и нативном 4K (до 16 мегапикселей) и редактирование с использованием до 16 референсных изображений. Для фоновых пакетных задач подойдёт более экономичная стандартная модель minimax/minimax-h3-image, а когда пользователь ждёт результат на экране в реальном времени — выбирайте эту версию 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") с 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 (при редактировании изображений отключение расширения промпта не поддерживается). Параметр 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 и не добавляйте --retry в curl, чтобы исключить двойную оплату при локальном таймауте.