
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.7 | MAI Image 2.7 Flash | |
|---|---|---|
| ID модели в PoYo | mai-image-2.7 | mai-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 | Те же |
| Выпуск Microsoft | 17 ноября 2026 | 17 ноября 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 мегапикселя. |
size | 1:1 (по умолчанию), 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 или собственный WIDTHxHEIGHT |
| Собственный размер | Обе стороны кратны 16, каждая сторона не меньше 768, всего не больше 4,194,304 пикселей; используется ровно так, как указан |
resolution | 1K (по умолчанию, около 1 мегапикселя, 1:1 — это 1024x1024) или 2K (около 4 мегапикселей, 16:9 — это 2720x1536) |
background | opaque (по умолчанию) или transparent; для прозрачности нужен png или webp |
output_format | png (по умолчанию), 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 в PoYo | MAI 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" | 2720x1536 | 27.802 кредита (около $0.139) | Около 66 с |
mai-image-2.7-flash, тот же запрос | 2720x1536 | 8.1803 кредита (около $0.041) | Около 42 с |
mai-image-2.7-flash, 1:1, 1K, background: transparent, png | 1024x1024 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, а не держите запрос открытым.