guides

MAI Image 2.7 API: что такое MAI Image 2.7, цены, лимиты и Flash

Poyo.ai Team
8 min read
Share:

MAI Image 2.7 API в PoYo

MAI Image 2.7 API даёт доступ к новейшей модели изображений от Microsoft AI через один REST-эндпоинт в PoYo: mai-image-2.7 для финальных материалов и mai-image-2.7-flash для более дешёвых и быстрых задач. Обе принимают одинаковое тело запроса, генерируют изображение по промпту или редактируют до 5 референсных изображений и могут возвращать прозрачные файлы PNG или WebP. На этой странице: что такое MAI Image 2.7, точные лимиты, цены токенов и что мы измерили в день запуска.

Что такое MAI Image 2.7?

MAI Image 2.7 — модель генерации и редактирования изображений от Microsoft AI (MAI), выпущенная вместе с MAI Image 2.7 Flash 17 ноября 2026 года. Согласно карточке модели Microsoft, это диффузионная модель с 20 миллиардами параметров без учёта эмбеддингов, созданная как для генерации изображений по тексту, так и для «точного, управляемого редактирования изображение-в-изображение», а MAI Image 2.7 Flash — «оптимизированная версия MAI Image 2.7».

Microsoft сообщает, что модель была «перестроена с нуля для мультимодальных сценариев редактирования», и среди операций редактирования называет удаление объектов, замену, изменение атрибутов, inpainting, обновление текста и устранение артефактов (например, смаза от движения). Также Microsoft утверждает, что MAI Image 2.7 заняла 1-е место в рейтинге AA-Image-Editing v2.1 от Artificial Analysis по состоянию на 16 ноября 2026 года, с результатом 1,215 Elo по 5,478 голосам.

Для интеграции через API это означает три типа запросов, которые стоит сюда отправлять:

  • Правки, которые не должны затрагивать остальное изображение: новый цвет товара, заменённый объект, переписанная вывеска или этикетка.
  • Изображения с текстом в кадре: в карточке модели Microsoft отмечено «улучшенное отображение текста в генерируемых изображениях, включая этикетки, постеры, упаковку и вывески».
  • Материалы, которым нужен настоящий альфа-канал: Microsoft сообщает, что обе модели «поддерживают прозрачный фон», а PoYo предоставляет это как background: "transparent".

MAI Image 2.7 API кратко

MAI Image 2.7MAI Image 2.7 Flash
ID модели в PoYomai-image-2.7mai-image-2.7-flash
Эндпоинт отправкиPOST https://api.poyo.ai/api/generate/submitТот же
РезультатОпрос GET /api/generate/status/{task_id} или callback_urlТак же
Режимы вводаТекст в изображение; редактирование 1 изображения; объединение от 2 до 5 изображенийТе же
Поля запросаprompt, image_urls, size, resolution, background, output_formatТе же
Выпуск Microsoft17 ноября 202617 ноября 2026
ДокументацияСправочник MAI Image 2.7 APIСправочник MAI Image 2.7 Flash (та же схема)

Две схемы PoYo различаются только ID модели, так что переключение между уровнями — это замена одной строки. Сравнение уровней показывает, когда какой из них окупается.

Лимиты и поля запроса

ПолеПравило в PoYo
promptОбязательно, от 1 до 32,000 символов, должно содержать не только пробельные символы. Точный текст для изображения берите в кавычки.
image_urlsНеобязательный массив из 1–5 публичных HTTP(S)-URL, JPEG, PNG или WebP. Одно изображение редактируется, несколько объединяются. Референсы используются в разрешении до примерно 1 мегапикселя.
size1:1 (по умолчанию), 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 или собственный WIDTHxHEIGHT
Собственный размерОбе стороны кратны 16, каждая сторона не меньше 768, всего не больше 4,194,304 пикселей; используется ровно так, как указан
resolution1K (по умолчанию, около 1 мегапикселя, 1:1 — это 1024x1024) или 2K (около 4 мегапикселей, 16:9 — это 2720x1536)
backgroundopaque (по умолчанию) или transparent; для прозрачности нужен png или webp
output_formatpng (по умолчанию), jpeg, webp
Изображений на запрос1

С image_urls и без size результат повторяет соотношение сторон первого референса в разрешении около 1 мегапикселя. Потолок в 4,194,304 пикселя совпадает с карточкой модели Microsoft, где указано такое же «максимальное общее число пикселей» и отмечено, что любая сторона может превышать 2048, пока общий объём укладывается в лимит.

Цены MAI Image 2.7 API

PoYo тарифицирует обе модели по токенам, по ставкам из нашего прайс-листа. 1 кредит = $0.005.

За 1M токеновMAI Image 2.7 в PoYoMAI Image 2.7 Flash в PoYo
Текстовый ввод1,000 кредитов ($5.00)350 кредитов ($1.75)
Ввод изображений1,600 кредитов ($8.00)500 кредитов ($2.50)
Вывод изображений6,800 кредитов ($34.00)2,000 кредитов ($10.00)

В PoYo число выходных токенов зависит от числа пикселей: примерно один токен на 1,024 пикселя. Изображение 1024x1024 — это около 1,024 выходных токенов, то есть около 6.96 кредита ($0.035) в MAI Image 2.7 и 2.05 кредита ($0.0102) во Flash, плюс небольшая плата за текстовые токены промпта. В разборе цен посчитаны все размеры.

Что мы измерили в день запуска

Команда PoYo выполнила эти запросы в продакшн-API PoYo 19 ноября 2026 года. Время указано от отправки до результата с точки зрения клиента, опрашивающего статус каждые несколько секунд, поэтому оно приблизительное.

ЗапросРезультатСтоимость по текущим ставкамВремя
mai-image-2.7, 16:9, 2K, png, кафе дождливой ночью с неоновой вывеской "OPEN LATE"2720x153627.802 кредита (около $0.139)Около 66 с
mai-image-2.7-flash, тот же запрос2720x15368.1803 кредита (около $0.041)Около 42 с
mai-image-2.7-flash, 1:1, 1K, background: transparent, png1024x1024 RGBA, полностью прозрачный фон2.062 кредита (около $0.0103)Около 42 с

В обоих прогонах с кафе на вывеске было написано "OPEN LATE" ровно как в промпте. Прогон с прозрачностью вернул настоящий альфа-канал, а не белый фон или «шахматку»; полный запрос приведён в руководстве по прозрачному фону.

Ваш первый запрос к MAI Image 2.7 API

curl https://api.poyo.ai/api/generate/submit \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mai-image-2.7",
    "input": {
      "prompt": "A university campus poster at dusk with the title \"Open Day 2026\", photorealistic, cinematic light",
      "size": "16:9",
      "resolution": "2K"
    }
  }'

Ответ содержит data.task_id со статусом not_started. Опрашивайте эндпоинт статуса, пока он не станет finished, и берите изображение из data.files[0].file_url, либо передайте callback_url на верхнем уровне, чтобы получить POST по завершении задачи. Всегда проверяйте поле code в теле ответа: некоторые ошибки валидации приходят с HTTP 200 и code: 400. В руководстве по API есть цикл опроса на Python с ограничением по времени и JSON-тело для каждого режима ввода.

Где доступна MAI Image 2.7

Microsoft предлагает MAI Image 2.7 как хостируемую модель, а не как веса для скачивания. Она находится в публичном предварительном доступе в Microsoft Foundry, где документация Microsoft перечисляет MAI-Image-2.7 и MAI-Image-2.7-Flash (версия 2026-11-02) в развёртывании Global Standard; попробовать модель можно в MAI Labs, который Microsoft описывает как предназначенный для личного некоммерческого использования.

В PoYo обе модели вызываются тем же API-ключом, что и любые другие модели, без подписки Azure и без шага развёртывания. Формат запроса в PoYo тоже отличается от Foundry: один JSON-эндпоинт принимает image_urls для правок (в Foundry для правок отдельный multipart-эндпоинт), а вместо «сырых» ширины и высоты вы выбираете соотношение сторон плюс 1K/2K или собственный размер.

Какие запросы куда направлять

ЗапросКакую модель вызывать
Финальные hero-изображения, точные правки, постеры и упаковка с большим количеством текстаmai-image-2.7
Черновики, превью, миниатюры, массовые задачи для каталогов и стикеровmai-image-2.7-flash
Промпты, которым нужны свежие факты из интернета (текущие события, реальные места)mai-image-2.6 с enable_web_search, см. MAI Image 2.6

MAI Image 2.7 не принимает параметр веб-поиска, который есть у MAI Image 2.6. Всё остальное из запроса 2.6 переносится как есть; в сравнении 2.7 и 2.6 перечислены изменения полей и diff для миграции.

Часто задаваемые вопросы

Какой ID модели у MAI Image 2.7 API? Используйте mai-image-2.7 для флагманской модели и mai-image-2.7-flash для Flash. mai-image-2-7 — это лишь slug страницы PoYo, как ID модели он отклоняется.

Сколько стоит MAI Image 2.7 API? В PoYo MAI Image 2.7 стоит $5.00 / $8.00 / $34.00 за 1M токенов текстового ввода, ввода изображений и вывода, а Flash — $1.75 / $2.50 / $10.00. Изображение 1024x1024 обходится примерно в $0.035 на MAI Image 2.7 и около $0.0102 на Flash.

MAI Image 2.7 API умеет генерировать новые изображения или только редактировать? И то и другое. Запрос только с prompt генерирует новое изображение. Если добавить от 1 до 5 URL в image_urls, тот же запрос становится правкой или композицией из нескольких изображений.

Поддерживает ли MAI Image 2.7 API прозрачный фон? Да. Отправьте "background": "transparent" вместе с "output_format": "png" или "webp". Наш тест Flash в день запуска вернул PNG 1024x1024 RGBA с полностью прозрачным фоном.

Какое самое большое изображение может вернуть MAI Image 2.7 API? 4,194,304 пикселя, например 2048x2048 или собственный 3072x1344. При 2K соотношение 16:9 даёт 2720x1536.

Сколько выполняется запрос к MAI Image 2.7 API? В нашем тесте 19 ноября 2026 года изображение 2K 16:9 заняло около 66 секунд на MAI Image 2.7 и около 42 секунд на Flash. Используйте опрос с дедлайном или callback_url, а не держите запрос открытым.

Share: