Перейти к основному содержанию
POST

Аутентификация

string
обязательно
Все методы используют Bearer Token. Получите ключ на странице ключей API.

О моделях

MiniMax H3 Image хорошо справляется с фотореализмом, постерами, предметной съемкой и изображениями с текстом. По умолчанию модель сначала автоматически расширяет промпт до подробного описания сцены и только затем генерирует изображение. Расширенный текст доступен в поле revised_prompt результата задачи. Чтобы генерировать строго по исходному тексту, см. Отключение улучшения промпта.
Если resolution не передан, по умолчанию выводится 4K (около 16 Мп), а цена примерно в 3,6 раза выше, чем у 1K / 2K. Если 4K не нужен, явно передайте "resolution": "2K".

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

string
обязательно
Название модели генерации изображений, всегда minimax-h3-image-highspeed.
string
обязательно
Текстовое описание создаваемого или редактируемого изображения.Поддерживаются китайский и английский языки. Длина после удаления начальных и конечных пробелов — от 1 до 32,000 символов.
string[]
Массив референсных изображений, не более 16. Наличие поля автоматически включает режим редактирования.Каждый элемент — публично доступная прямая ссылка http(s):// или встроенный Base64 в формате data:image/png;base64,... (платформа сначала преобразует его в ссылку, а затем передает модели).Подробнее: Требования к референсам.
string
по умолчанию:"auto"
Соотношение сторон или точный размер выходного изображения в пикселях.Поддерживается:
  • auto: модель сама выбирает композицию и пропорции по промпту
  • Соотношение сторон: формат X:Y, где X и Y — целые числа от 1 до 300, а соотношение находится в пределах от 1:3 до 3:1 включительно, например 1:1, 4:3, 16:9, 9:16, 3:1
  • Точные пиксели: ширинаxвысота, например 2048x1152 (также допускаются разделители X, ×, *)
Подробнее: Правила размеров.
string
по умолчанию:"4K"
Уровень разрешения; вместе с соотношением сторон определяет фактический размер в пикселях.
  • 1K: около 1 Мп
  • 2K: около 4,2 Мп
  • 4K (по умолчанию): около 16 Мп
Допускается запись в нижнем регистре.
Если size задан в точных пикселях, resolution передавать нельзя — иначе вернется 400.
integer
по умолчанию:"1"
Количество изображений, от 1 до 10.
boolean
по умолчанию:"true"
Автоматически расширять промпт или нет.Значение false действует только для генерации по тексту и требует явно заданного размера; см. Отключение улучшения промпта.
string
по умолчанию:"jpeg"
Формат выходного файла.
  • jpeg (по умолчанию, также можно jpg)
  • png
  • webp
integer
по умолчанию:"95"
Качество сжатия от 0 до 100; не применяется к png.
boolean
по умолчанию:"false"
Добавлять ли на изображение видимый водяной знак об ИИ-генерации. Не влияет на скрытую маркировку в метаданных изображения.
Следующие параметры не поддерживаются и игнорируются: quality, style, seed, negative_prompt, background, mask_url.Результат всегда возвращается в виде URL; при передаче response_format: "b64_json" вернется 400.

Правила размеров

Уровень + соотношение сторон

Уровень задает общую площадь, соотношение сторон — форму: Фактический размер в пикселях модель округляет по соотношению сторон и уровню; ориентируйтесь на возвращенный результат. Для точного размера используйте запись в пикселях.

Точные пиксели

При использовании size: "ширинаxвысота" должны выполняться условия:
  • ✅ 1024x1024, 2048x1152, 1536x1536, 4000x5000
  • ❌ 512x512 (слишком малая площадь), 4000x1000 (соотношение больше 3:1), 5000x5000 (больше 20 Мп)

Требования к референсам

При использовании URL убедитесь, что ссылка публично доступна. Если ссылка недоступна, задача завершится ошибкой на этапе генерации (status будет failed, средства возвращаются полностью).В режиме редактирования улучшение промпта всегда включено и не может быть отключено.

Отключение улучшения промпта

По умолчанию модель сначала расширяет промпт, а затем генерирует изображение. Чтобы генерировать строго по исходному тексту, передайте "prompt_optimizer": false при следующих условиях:
  • Только для генерации по тексту: при наличии image_urls вернется 400
  • Размер нужно задать явно: size должен быть соотношением сторон (например, 1:1) или размером в пикселях (например, 1024x1024), но не auto и не пустым
При отключении модель читает примерно первые 4096 токенов промпта.

Response

integer
Код ответа; 200 при успешной отправке.
array
Данные ответа на отправку.

Ответ на отправку

После успешной отправки сразу возвращается ID асинхронной задачи:

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

Передайте task_id из ответа на отправку в метод запроса задачи:
Скоростная версия генерирует быстрее стандартной (у стандартной по замерам одно изображение 1K / 2K — примерно 10 ~ 20 секунд, 4K — около 20 секунд). Рекомендуем опрашивать статус каждые 3 ~ 5 секунд, пока он не станет completed или failed. Одна задача может выполняться до 600 секунд, поэтому таймаут опроса на клиенте лучше установить в 10 минут.

Успешная задача

Ссылки на изображения находятся в data.result.images[0].url[]: все n изображений собраны в одном массиве. Скачайте и сохраните их до expires_at. При ошибке задачи status будет failed, причина указана в error.message, а средства автоматически возвращаются полностью.

Примеры использования

Генерация по тексту (по умолчанию 4K)

Генерация по тексту (1K + соотношение сторон, 4 изображения)

Точные пиксели + PNG

Редактирование по референсам

Отключение улучшения промпта