yandex

MAI Image 2.5 API

starstarstarstarstar

5/5

MAI Image 2.5 — нейросеть от Microsoft для генерации и редактирования изображений. Модель умеет создавать картинки по текстовому описанию, а также изменять существующие изображения по инструкции.

ID для подключения по API : mai-image-2-5

Средняя скорость генерации ~ 46.62 сек
Дата выхода: 04/09/2026

Изображения

Генерация по тексту

Базовая генерация

Редактирование

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

Ретушь и детали

Генерация по картинке

Смена/расширение фона

Стандартная

Запустить через API
SoTA

Стандартная

Запустить через API
SoTA

Выберите язык:

Как работать с MAI Image 2.5 через API?

Получение API ключа

Для начала получите ваш API ключ в личном кабинете, если ещё не сделали этого.

Это ваш API-ключ с помощью, которого вы можете генерировать. Не сообщайте его никому.

Запрос на выполнение задачи

Теперь необходимо создать задачу на генерацию. Результат вы можете получать по-разному, можно по системе Long-Pooling, либо вы можете задать callback_url и мы отправим вам результат по готовности. Подробнее с тем, как использовать эти способы можете ознакомиться в документации. В данном примере мы рассмотрим способ с получением результата на callback_url.

В этом запросе указаны лишь обязательные параметры, если вам необходимы дополнительные параметры, то можете ознакомится с ними здесь

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

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

На указанный в первом запросе callback_url придёт следующий ответ.

Ознакомиться с другими способами получения результата можете в документации

Параметры для генерации

callback_urlurl

Это URL, на который будет отправлен ответ от нейросети.

is_syncboolean

Выбор режима выполнения запроса: синхронно или асинхронно.

Значение по умолчанию : false

promptstring

Обязательно

Промпт.

Значение по умолчанию : Солнечный кадр на улице: модель в винтажном спортивном костюме и гольфах лежит на траве. Тёплая утопическая эстетика в духе Тайлера Митчелла, мягкий золотой свет, ностальгическая пастельная палитра, радостная расслабленная американа, лёгкое зерно плёнки

image_urlurl_or_file

Входное изображение.

num_imagesinteger

Количество изображений на выходе.

Значение по умолчанию : 1

aspect_ratiostring

Соотношение сторон.

Значение по умолчанию : 16:9

output_formatstring

Формат выходного изображения.

Значение по умолчанию : png