MiniMax H3 Image API

ПровайдерMinimax

minimax-h3-image — генерация изображений-модель от Minimax.

image_to_imagetext_to_image

Попробуйте прямо здесь

Что умеет MiniMax H3 Image

  • Редактирование изображений
  • Изображение по тексту

Стоимость

за 1 млн входных токенов изображения
Входные токены изображения
200 ₽
за 1 млн входных текстовых токенов
Токены текста
306 ₽
за 1 млн выходных токенов изображения
Выходные токены изображения
505 ₽
за запрос
За референс, ориентировочно
0.412 ₽
за изображение
1K, ориентировочно
3.33 ₽
2K, ориентировочно
5.99 ₽
4K и произвольный размер, ориентировочно
11.97 ₽

Цены указаны в рублях и списываются с баланса проекта за успешные запросы. Надбавки (+) суммируются с базовой ставкой.

Технические характеристики

Vendor
minimax
Modality
image

MiniMax H3 Image API

MiniMax H3 Image создает изображения по тексту и редактирует их по референсам. Модель подходит для иллюстраций, карточек товаров, плакатов и композиций из нескольких исходных изображений. Можно указать 1K, 2K или 4K либо задать точный размер до 20 мегапикселей. Для редактирования добавьте до 16 референсов и опишите, какую роль играет каждый.

Параметры запроса

Параметры, которые принимает модель. Передаются в теле запроса.

ПараметрТипДиапазон / значенияПо умолчаниюОписание
positivePromptreq
string
—
—
Описание изображения или желаемых изменений.
1 пример
Примеры
Красный куб на белом фоне.
resolution
enum
1K, 2K, 4K
—
Автоматический размер. Без настроек размера используется 4K. Указывайте отдельно от width и height.
width
integer
min: 468 · max: 7745
—
Ширина в пикселях. Указывайте вместе с height. Площадь от 655360 до 20000000 пикселей, пропорции от 1:3 до 3:1.
height
integer
min: 468 · max: 7745
—
Высота в пикселях. Указывайте вместе с width.
inputs.referenceImages
array of strings
min: 1 · max: 16
—
От 1 до 16 референсов. Принимаются ссылки, UUID, data URI и Base64. Каждый референс от 128 до 8192 px на сторону, пропорции до 4:1.
settings.promptOptimizer
boolean
—
true
Уточняет описание перед генерацией. Можно выключить с точным размером и без референсов.
numberResults
integer
min: 1 · max: 1
1
Одно изображение за запрос.
outputType
enum
URL
URL
Результат возвращается по ссылке.
outputFormat
enum
JPG, PNG, WEBP
JPG
Формат изображения.
outputQuality
integer
min: 20 · max: 99
95
Качество компрессии.
async
boolean
—
—
Получить идентификатор задачи для опроса результата.

Параметры ответа

Что возвращает API. У медиа-моделей формат зависит от режима: sync — сразу результат, async — task_id для опроса через GET /v1/tasks/{id}.

Sync (HTTP 200)

HTTP 200 с изображением в data[].url.

Async (HTTP 202)

HTTP 202 с id задачи. Проверяйте готовность через GET /v1/tasks/{id}.

Пример кода

minimax-h3-image_example.py
from openai import OpenAI

client = OpenAI(api_key="rk_live_...", base_url="https://api.ranvik.ru/v1")
resp = client.images.generate(
    model= "minimax-h3-image",
    positivePrompt= "Пример промпта",
    resolution= "1K",
    width= 4107,
    height= 4107,
    numberResults= 1,
    outputType= "URL",
    outputFormat= "JPG",
    outputQuality= 95,
    async= False,
    inputs= {
        "referenceImages": []
    },
    settings= {
        "promptOptimizer": True
    },
)
print(resp)
Полная документация модели

Частые вопросы о MiniMax H3 Image

MiniMax H3 Image — модель MiniMax для генерации и редактирования статичных изображений по тексту и референсам. Она создает детализированные сцены и композиции.
Модель помогает быстро создавать иллюстрации, рекламные креативы, концепт-арт, изображения для карточек товаров и визуалы для проектов без ручной отрисовки.
Создайте ключ в кабинете Ranvik API и укажите minimax-h3-image в поле model. Для генерации отправьте запрос на /v1/images/generations.
Ranvik API позволяет подключать MiniMax H3 Image из России без VPN. Достаточно получить API-ключ в личном кабинете и интегрировать модель в привычный рабочий процесс.
Да, через Ranvik API доступна оплата в российских рублях. Это упрощает расчеты для команд и разработчиков: не нужно использовать зарубежные карты и валютные платежи.
Модель возвращает изображение в JPG, PNG или WebP. Можно выбрать 1K, 2K или 4K либо указать точную ширину и высоту в пределах 20 мегапикселей.