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.