MiniMax

MiniMax H3 Image

minimax-h3-image/image-to-image

Модель изображений MiniMax: генерация по тексту и редактирование с 1–16 референсными изображениями работают на едином наборе возможностей, вывод до 4K, поддержка десяти форматов кадра и автоматического соотношения сторон — подходит для концепт-дизайна, коммерческой визуализации и создания работ в разных стилях

minimax-h3-image/image-to-image minimax-h3-image/text-to-image

Попробовать minimax-h3-image/image-to-image

Ввод

Работы

Все работы

Вывод

image

Заполните параметры и сгенерируйте — результаты появятся здесь.

От реализма к флэту: иллюстративный спектр одной женщины

Стиль перенос стиля · редакционная-иллюстрация · Плоская векторная графика

Референсные входы

image_urls

Промпт

Плоская векторная редакционная иллюстрация: молодая женщина стоит в непринуждённой позе в три четверти, руки мягко скрещены, взгляд направлен на зрителя. Референс переосмыслен: фотографические детали сжаты до нескольких лаконичных плоскостей цвета — волосы превращаются в единый плавный силуэт, складки пальто упрощены до двух-трёх мягких дуг, лицо сохраняет лишь основные черты, переданные минималистичной двухтоновой светотенью кожи. Сдержанная тёплая палитра: терракота, мягкий кремовый, пыльно-розовый и тёмные чернильные линии; вокруг фигуры оставлено чистое пустое пространство, фон — простая геометрическая подложка из перекрывающихся кругов и одной горизонтальной цветовой полосы. Аккуратная заливка без зерна, уверенный штрих, фактура современной журнальной иллюстрации; мягкий рассеянный свет передан цветовыми пятнами, а не градиентами.

Скопируйте полный промпт и адаптируйте под свою задачу.

Теги

Матовый стеклянный флакон для ухода за кожей · вертикальное изображение товара для электронной коммерции

Стиль Изображение продукта · Упаковка · Студийный свет

Референсные входы

image_urls

Промпт

Флакон премиальной сыворотки для ухода за кожей с матовым шлифованным белым стеклянным корпусом, стоящий вертикально в центре на каменном постаменте светло-песочного оттенка, с крышкой-дозатором из брашированного алюминия. Плечи флакона округлые, линии мягкие; на корпусе оставлена пустая зона для этикетки, негативное пространство чистое и аккуратное. На фоне — матовая гипсовая стена в тёплых нейтральных тонах той же гаммы, с мягким градиентным переходом к краям. Мягкий полосовой луч света косо скользит по левой стороне стекла, подчёркивая матовую фактуру и образуя тонкий чёткий блик по краю, при этом на поверхности постамента появляется слабое отражение. Рядом с основанием — несколько мелких капель воды. Стиль студийной предметной съёмки, контролируемые мягкие тени, малая глубина резкости, флакон в чётком фокусе, фон мягко размыт, реалистичная фактура стекла и металла, нейтральная цветокоррекция, тёплые блики и холодные тени.

Скопируйте полный промпт и адаптируйте под свою задачу.

Теги

Цены

minimax-h3-image/image-to-image per image

Характеристики	Цена за единицу
1K	$0.0129 + $0.0036 Per Reference Image
2K	$0.0129 + $0.0036 Per Reference Image
4K	$0.0393 + $0.0036 Per Reference Image

Краткое описание

Сервис генерации «изображение в изображение» на основе референсных изображений, предназначенный для разработчиков, которым нужны редактирование и композитинг изображений. Принимает от 1 до 16 изображений в форматах JPG, PNG или WEBP в качестве референсов, на которые в промпте ссылаются по порядку как Picture 1, Picture 2 и т. д., описывая требуемое редактирование или объединение. На выходе — статичное изображение с поддержкой трёх уровней разрешения (1K, 2K, 4K) и различных соотношений сторон; доступны форматы JPEG или PNG. Подходит для концепт-дизайна, правки визуальных материалов и композитинга нескольких изображений.

Ключевые особенности

Поддержка объединения нескольких референсов — в одном запросе можно передать до 16 референсных изображений и редактировать или комбинировать несколько изображений; каждое референсное изображение оплачивается отдельно.
Выбор уровня разрешения вывода — доступны три уровня: 1K, 2K и 4K, что соответствует примерно 1MP, 4MP и 16MP; можно выбрать подходящий под задачу.
Воспроизводимость результата при фиксированном seed — параметр seed позволяет зафиксировать случайное зерно для воспроизведения результата; если не указан, используется случайное.
Автоматический выбор соотношения сторон — по умолчанию aspect_ratio равен auto: модель сама определяет соотношение по промпту и референсам; также можно задать одно из 10 фиксированных соотношений.

Возможности

Редактирование и объединение по нескольким референсам: передайте от 1 до 16 референсных изображений и промпт для редактирования длиной до 5000 символов, ссылаясь на изображения по порядку как Picture 1, Picture 2 и т. д. Можно редактировать существующие изображения или объединять несколько изображений в новую композицию; на выходе — статичное изображение.

Управление разрешением и соотношением сторон: resolution принимает значения 1K, 2K или 4K, что соответствует примерно 1MP, 4MP и 16MP; aspect_ratio поддерживает 11 соотношений, включая 1:1, 16:9, 21:9 и др., по умолчанию auto — модель определяет его автоматически по промпту и референсам.

Формат вывода и управление seed: output_format может быть jpeg или png; файл PNG при 2K весит около 12MB, при 4K — около 30MB; seed принимает целое число от 0 до 2147483647 и служит для воспроизведения результата; если не указан, используется случайное значение.

Сценарии применения

Правка концепт-дизайна по референсам — дизайнер загружает референсы персонажа или сцены и описывает направление изменений, получая отредактированный концепт-арт для проработки вариантов и визуальной коммуникации.
Композитинг коммерческих визуальных материалов из нескольких изображений — несколько изображений товаров или фонов подаются как референсы, а на выходе получается объединённый материал высокого разрешения для рекламы и электронной коммерции.
Редактирование существующих изображений по инструкции — операторы или авторы контента загружают готовые изображения и описывают нужные правки, получая изменённое статичное изображение для соцсетей или иллюстраций на страницах.

Ограничения и рекомендации по выбору

Каждый запрос должен содержать не менее 1 и не более 16 референсных изображений; длина стороны каждого изображения должна быть от 128 до 8192 пикселей, размер — не более 20MB, формат — только JPG, PNG или WEBP. Промпт — до 5000 символов и должен содержать непустой текст. Референсные изображения оплачиваются поштучно. На выходе — статичное изображение; генерация видео или аудио не поддерживается. Файлы PNG заметно больше JPEG и при 4K весят около 30MB, поэтому следует учитывать затраты на хранение и передачу.

Новости

Смотреть changelog →

Новая модель MiniMax H3 Image запущен: генерация изображений по тексту и редактирование по нескольким референсам Nov 12, 2026

Частые вопросы

Все частые вопросы →

Сколько референсных изображений можно передать максимум?

При генерации изображения по изображению можно передать максимум 16 референсных изображений, минимум 1, в формате JPG, PNG или WEBP, со стороной 128–8192 px, каждое не более 20 MB. За каждое референсное изображение дополнительно взимается $0.0036; например, для 2K с 3 референсными изображениями итого $0.0129 + 3 × $0.0036 = $0.0237. При написании промпта ссылайтесь на изображения по порядку передачи номерами вида Picture 1, Picture 2, чтобы модель правильно сопоставила их с объектами, которые вы хотите отредактировать или объединить.
Как задаются выходные размеры и насколько большими они могут быть?

Доступны три уровня разрешения: 1K, 2K и 4K, что соответствует примерно 1 MP, 4 MP и 16 MP; по умолчанию — 2K. Соотношение сторон можно выбрать: auto или 1:1, 5:4, 4:5, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9; при выборе auto модель сама определит его на основе промпта и референсных изображений, а если нужна фиксированная композиция, укажите его явно.
Как писать запрос, чтобы сохранить внешность персонажа?

Стройте запрос в таком порядке: сначала опишите объект, который нужно сохранить, затем — часть, которую нужно изменить, и в конце укажите изображения по номерам: ① сначала одной-двумя фразами зафиксируйте внешние признаки объекта, такие как причёска, одежда, цветовая гамма, характерные детали; ② затем опишите целевую сцену, позу, ракурс и освещение; ③ если нужно сослаться на референсное изображение, пишите «персонаж на Picture 1», а несколько изображений нумеруйте в порядке передачи. Ограничение запроса — 5000 символов; подробности в основном тексте работают эффективнее нагромождения прилагательных.
Как сделать набор изображений одного и того же персонажа с разных ракурсов?

Сначала используйте один чёткий референс с хорошо видимым объектом без перекрытий в качестве Picture 1, зафиксируйте в промпте описание черт персонажа, затем генерируйте изображения по одному, меняя только описание угла или позы, например: анфас, профиль, вид со спины, поясной и полноростовой портрет, с фиксированным соотношением сторон 3:4 или 1:1. Сохранение одинакового seed для каждого изображения помогает уменьшить случайные различия; стилистическая согласованность серии изображений в основном поддерживается за счёт референса и фиксированного описания объекта.

Создать задачу генерации

POST https://api.hiapi.ai/v1/tasks

Заголовки

AuthorizationstringОбязательно

API-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ

Content-TypestringНеобязательно

Тело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.

Idempotency-KeystringНеобязательно

Ключ идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.

Ключ идемпотентности

При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.

Тело запроса

modelstringОбязательно

Текущее фиксированное значение: minimax-h3-image/image-to-image

routestringНеобязательно

Текущее фиксированное значение: default

inputobjectОбязательно

Объект бизнес-параметров для minimax-h3-image/image-to-image и маршрута default — см. таблицу параметров ниже.

seedintegerНеобязательноmin 0max 2147483647

Случайное зерно для воспроизведения одного и того же результата; принимает целое число, при пропуске используется случайное зерно.

promptstringОбязательноminLength 1maxLength 5000pattern \S

Текст инструкции редактирования; ссылки на изображения-образцы указываются по порядку как Picture 1, Picture 2 и т. д.; длина от 1 до 5000 символов.

image_urlsarrayОбязательноminItems 1maxItems 16

Массив изображений-образцов для редактирования или композитинга; элементы представляют собой URL-адреса изображений; поддерживается от 1 до 16 изображений в форматах JPG, PNG или WEBP, размер каждой стороны от 128 до 8192 px, максимальный размер одного файла 20 MB; каждое изображение-образец оплачивается отдельно.

Array [ string ]

resolutionstringНеобязательноПо умолчанию: "2K"

Уровень разрешения выходного изображения: 1K — около 1 MP, 2K — около 4 MP, 4K — около 16 MP; по умолчанию 2K.

Варианты:1K2K4K

aspect_ratiostringНеобязательноПо умолчанию: "auto"

Соотношение сторон выходного кадра; по умолчанию auto — модель выбирает самостоятельно на основе подсказки и изображений-образцов.

Варианты:auto1:15:44:54:33:43:22:3

Показать все (3)Свернуть

16:99:1621:9

output_formatstringНеобязательноПо умолчанию: "jpeg"

Формат выходного изображения; по умолчанию jpeg, файлы PNG заметно больше по размеру (около 12 MB при 2K и около 30 MB при 4K).

Варианты:jpegpng

callbackobjectНеобязательно

Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.

Обратные вызовы (Webhook)

Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.

urlstringОбязательно

Обязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.

whenstringНеобязательноПо умолчанию: "final"

Сейчас поддерживается только final — уведомление и при success, и при fail.

Варианты:final

storagestringНеобязательноПо умолчанию: "temp"

Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.

Варианты:temppersistent

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

# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-h3-image/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "resolution": "2K",
    "aspect_ratio": "auto",
    "output_format": "jpeg"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "minimax-h3-image/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "resolution": "2K",
      "aspect_ratio": "auto",
      "output_format": "jpeg"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "minimax-h3-image/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "resolution": "2K",
          "aspect_ratio": "auto",
          "output_format": "jpeg"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Получить детали задачи

GET https://api.hiapi.ai/v1/tasks/:id

Поля ответа

taskIdstringОбязательно

Идентификатор задачи, всегда с префиксом tk-hiapi-.

modelstringОбязательно

Полное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.

routestringНеобязательно

Присутствует только при явном параметре route; повторяет переданное значение.

statusstringОбязательно

Статус задачи.

Значения статуса

queued В очереди, ещё не начата. handling Обрабатывается. archiving Обработка завершена, готовятся артефакты. success Терминальное: завершено, артефакты доступны (возвращается output). fail Терминальное: ошибка (возвращается error). После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.

creatednumberОбязательно

Время создания задачи (Unix-секунды).

completednumberОбязательно

Unix-секунды терминального состояния; до этого — 0.

outputarrayНеобязательно

Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).

Array [ object ]

Элементы массива

urlstringОбязательно

URL артефакта, доступен для скачивания напрямую.

typestringОбязательно

Текущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.

expireAtnumberОбязательно

Unix-секунды доступности артефакта; скачайте или перенесите до истечения.

errorobjectНеобязательно

Только при status == fail.

codestringОбязательно

Бизнес-код ошибки.

messagestringОбязательно

Описание ошибки.

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

Успех

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Обработка (не финальное)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Ошибка

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}