MiniMax H3 Image API: генерация, редактирование и реальные цены

Цены одной модели у разных провайдеров: Cheap MiniMax H3 Image API · 2026-11-13

Возможности MiniMax H3 Image и ограничения хостингового API

Главная причина присмотреться к H3 Image — единый рабочий процесс генерации и редактирования: опишите новый объект, приложите референсы продукта или персонажа, затем запросите точечное изменение. MiniMax также публикует веса для локального развёртывания. Заявленные возможности не гарантируют точного воспроизведения логотипов, типографики или идентичности в каждом результате.

Возможность хостингового API	Документированный контракт
Генерация	POST /v1/images/generations
Редактирование	POST /v1/images/edits, 1–16 референсных изображений
Промпт	До 32 000 символов; без улучшения промпта реально учитываются только первые примерно 4 096 токенов
Размеры вывода	655 360–20 000 000 пикселей; соотношение сторон от 1:3 до 3:1
Количество изображений	n от 1 до 10
Форматы	По умолчанию JPEG; поддерживаются PNG и WebP
Ответы	URL или Base64 без стриминга; поддерживается нативный SSE
Неподдерживаемые параметры	Редактирование по маске, прозрачный фон и preview-изображения

Референсные файлы должны соответствовать ограничениям MiniMax на ввод: JPG/JPEG, PNG, WebP, HEIC или HEIF, каждая сторона 128–8 192 пикселя, отношение длинной стороны к короткой не более 4:1, а общий размер тела запроса — не более 64 MiB. Base64 увеличивает размер запроса. Используйте доступные по URL изображения или загрузки подходящего размера; способность модели принять 16 изображений не отменяет ограничение на размер тела запроса.

«4K» в этом API — это настройка площади. area: "4K" нацелена примерно на 4096 × 4096 пикселей, а конкретные размеры выводятся из соотношения сторон. При 16:9 документированный вывод — 5472 × 3072, а не 4096 × 2304. Для явных размеров передавайте size: "WIDTHxHEIGHT" и опускайте area и aspect_ratio. Для размеров на основе площади используйте size: "auto", area и aspect_ratio. Проверяйте data[].size и фактические размеры скачанного изображения.

Сколько стоит MiniMax H3 Image?

Для текущего маршрута APIMaster Standard расчёт по обычному тарифу выглядит так:

USD = (text_input_tokens × 2.30
     + image_input_tokens × 1.50
     + image_output_tokens × 3.80) / 1,000,000

Используйте отдельные поля использования для текста и изображений; не тарифицируйте все входные токены как текстовые и не добавляйте ввод изображений повторно. Улучшение промпта добавляет оплачиваемые текстовые токены, поэтому разрешение само по себе не определяет итоговую цену. Применимые к аккаунту коэффициенты и округление при тарификации могут влиять на итоговое списание.

Официальные иллюстративные итоги Standard от MiniMax показывают масштаб счёта. Это примеры, а не фиксированные тарифы APIMaster или наш измеренный средний показатель:

Задача	1K: 1024 × 1024	2K: 2048 × 2048	4K: 4096 × 4096, обычный тариф
Генерация из текста	$0.02179	$0.02333	$0.06879
Редактирование с одним референсом 1K	$0.02654	$0.02658	$0.07312
Редактирование с тремя референсами 1K	$0.03563	$0.04177	$0.07914

Для контекста: 1 000 запросов генерации из текста по первому примеру — это примерно $21.79; это иллюстративный расчёт по бюджету токенов, а не предоплаченный пакет. Реальные промпты и улучшение промпта могут его изменить. У Nano Banana 2.1 другой контракт APIMaster, основанный на разрешении, — от $15.12 за 1 000 изображений 1K, не считая отдельно оговорённых условий.

Применяется ли официальная 50-процентная акция на 4K на APIMaster?

Не стоит исходить из того, что применяется. MiniMax рекламирует скидку 50% на полную стоимость запроса для Standard и Highspeed до 17 ноября 2026 года, 16:00 UTC, не включительно — 18 ноября, 00:00 по пекинскому времени, — при условии, что итоговое поставленное изображение содержит не менее 16 600 000 пикселей. Её квадратный пример генерации из текста в 4K меняется с $0.06879 на $0.03439 в течение этого предложения.

Вывод 4096 × 4096 подходит по площади; 4096 × 2304 — нет. Одной метки «4K» недостаточно. Текущий публичный маршрут APIMaster использует обычные тарифы по токенам, без этой временной акции. Сравнивайте фактический контракт оформления заказа и использования, а не рекламный заголовок MiniMax. После окончания срока промо-примеры не следует использовать как актуальные цены.

Пример API MiniMax H3 Image: генерация из текста

Создайте аккаунт APIMaster, пополните баланс для платных запросов изображений, затем создайте ключ в разделе API-ключи. Задайте APIMASTER_API_KEY в своём окружении. В этом примере используется точный, чувствительный к регистру ID модели маршрута Standard:

import os
import requests

base_url = "https://apimaster.ai/v1"
headers = {"Authorization": f"Bearer {os.environ['APIMASTER_API_KEY']}"}
response = requests.post(
    f"{base_url}/images/generations",
    headers=headers,
    json={
        "model": "MiniMax-H3-Image",
        "prompt": "A studio product photo of a matte blue teapot and two pears on a cream table, soft daylight, no text.",
        "size": "auto",
        "aspect_ratio": "16:9",
        "area": "2K",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
response.raise_for_status()
result = response.json()
for item in result.get("data", []):
    if item.get("error"):
        print("Image failed:", item["error"])
    else:
        print(item.get("url"), item.get("size"))
print("Usage:", result.get("usage"))

Это пример запроса, а не бенчмарк качества изображений. Скачивайте URL успешных результатов promptly и храните файлы самостоятельно. Проверяйте ошибки по каждому изображению: при n > 1 ответ HTTP 200 может содержать неудачные изображения. Тайм-аут не доказывает, что запрос был отклонён. Генерация H3 не идемпотентна, поэтому автоматический повтор может создать ещё одну оплачиваемую генерацию. Если используете OpenAI SDK, задайте достаточно длинный тайм-аут и max_retries=0.

Редактирование в MiniMax H3 Image: референсные изображения и управление промптом

Для редактирования через JSON передавайте референсные URL в images[].image_url. Не переносите поле image_urls из Nano Banana в этот запрос к H3. Замените примерные URL на свои доступные ассеты:

edit = requests.post(
    f"{base_url}/images/edits",
    headers=headers,
    json={
        "model": "MiniMax-H3-Image",
        "prompt": "Keep the product shape and label from image 1. Use the background palette from image 2. Do not add text or change the product.",
        "images": [
            {"image_url": "https://example.com/product.png"},
            {"image_url": "https://example.com/palette.png"},
        ],
        "size": "2048x2048",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
edit.raise_for_status()
print(edit.json())

Проверки приёмки существующей интеграции APIMaster от 11 ноября охватывали HTTP-референсы, data URI, multipart-загрузки, редактирование с несколькими референсами, SSE и декодированные результаты 1K/2K/4K. Контролируемый тест с двумя референсами сохранил четыре цветные фигуры и две короткие метки. Это были проверки интерфейса и тарификации на простых ассетах, а не широкомасштабная оценка фотографий или типографики; они не устанавливают превосходство над другой моделью.

Генерация по умолчанию использует улучшение промпта; его можно отключить параметром disable_prompt_enhanced: true, задав при этом фиксированные размеры или фиксированное соотношение сторон. Редактирование всегда использует улучшение. Изучайте revised_prompt при диагностике неожиданных изменений. Для работы с продуктами укажите, что должно остаться неизменным, определите роль каждого референса и проверьте отрисованную метку перед публикацией.

Standard vs Highspeed, открытые веса vs хостинговый API

Highspeed использует те же документированные параметры API, но его официальные тарифы на ввод и вывод изображений вдвое выше, чем у Standard; текстовый ввод остаётся $2.30/M. Сейчас на APIMaster представлен только Standard. Заявления MiniMax о скорости на старте зависят от варианта модели, размера и развёртывания и не являются измеренной гарантией задержки на APIMaster.

Официальный репозиторий на Hugging Face предоставляет веса и интеграции, включая Diffusers, SGLang, vLLM-Omni и ComfyUI. Его BF16-чекпоинт занимает около 68.65 GB, плюс отдельный текстовый энкодер примерно на 66.7 GB. Размер загрузки — не полная оценка объёма памяти GPU. Локальные веса распространяются по лицензии сообщества MiniMax H3 Image, поэтому изучите эту лицензию перед развёртыванием; «открытые веса» не означают неограниченное использование по MIT или Apache.

Используйте хостинговый доступ, чтобы оценивать промпты без создания инфраструктуры инференса. Рассмотрите локальное развёртывание, когда контроль над инференсом оправдывает затраты на GPU, обслуживание и лицензирование. Ограничения локального пайплайна и ограничения хостингового API — это разные контракты.

FAQ

MiniMax H3 Image — это то же самое, что MiniMax H3 video?

Нет. H3 Image генерирует и редактирует статичные изображения через MiniMax-H3-Image. У семейства H3 video другие ID моделей, эндпоинты и тарификация. Смотрите отдельное руководство по MiniMax H3 video.

Доступна ли MiniMax H3 Image на APIMaster?

Да. Проверка 13 ноября выявила один включённый публичный маршрут Standard с тарификацией $2.30/M за текстовый ввод, $1.50/M за ввод изображений и $3.80/M за вывод изображений. У Highspeed публичного маршрута не было. Проверьте действующую карточку модели перед отправкой запросов.

H3 Image — это API с фиксированной ценой $0.02 за изображение?

Нет. Официальные примеры цен за изображение — это иллюстративные итоги. Фактическое использование токенов, улучшение промпта, референсные входы и размеры вывода определяют счёт. Текущий маршрут APIMaster использует обычную формулу по токенам.

Может ли H3 Image редактировать с 16 референсами или маской?

Он документирует до 16 референсных изображений в пределах ограничений на формат и размер запроса. Редактирование по маске и прозрачный фон не поддерживаются. Инструкции на основе референсов не гарантируют попиксельно точного сохранения.

Что дешевле: H3 Image или Nano Banana 2.1?

Для иллюстративной задачи генерации из текста в 1K обычный официальный пример H3 — $0.02179, против APIMaster Nano Banana 2.1 от $0.01512 за изображение 1K. Здесь сравнивается примерный итог по токенам с котировкой по разрешению; измеряйте фактическую стоимость принятых результатов для своих промптов. Смотрите отдельное сравнение.

Источники и дальнейшие шаги

Источники проверены 13 ноября 2026 года: релиз MiniMax, руководство по хостинговому API, официальные цены и акция, веса модели и лицензия, цены Google на изображения и действующие карточки маркетплейса APIMaster. Описания возможностей взяты у соответствующих вендоров; проверки цен и датированные наблюдения по интеграции APIMaster указаны отдельно.

Откройте карточку H3 Image, зарегистрируйтесь, создайте API-ключ и отправьте MiniMax-H3-Image на https://apimaster.ai/v1. Для альтернативы со скидкой и другим контрактом тарификации сравните маршруты Nano Banana 2.1, сейчас до 55% ниже референса Google по выводу изображений.