
MAI Image 2.7 API умеет возвращать изображения с настоящим альфа-каналом, так что вырезки товаров, логотипы, иконки и стикеры сразу готовы к размещению на любом фоне без этапа маскирования. В PoYo для этого нужны два поля, background и output_format, на mai-image-2.7 или mai-image-2.7-flash. В нашем тесте в день запуска прозрачный PNG 1024x1024 на Flash по текущим ставкам обходится в 2.062 кредита, около $0.0103. Попробуйте это на странице модели MAI Image 2.7, прежде чем встраивать в код.
Что Microsoft говорит о прозрачности
В анонсе Microsoft сказано, что «обе модели поддерживают прозрачный фон для готовых к использованию изображений товаров», а в качестве других применений названы логотипы, иконки и иллюстрации. Документация Foundry называет прозрачный фон возможностью, которую MAI-Image-2.7 добавляет по сравнению с более ранними моделями изображений MAI, «для материалов вроде изображений товаров, логотипов, иконок и элементов дизайна, которые нужно размещать поверх другого контента». У MAI Image 2.6 такой опции нет.
Два поля
| Поле | Значения | По умолчанию | Правило |
|---|---|---|---|
background | opaque, transparent | opaque | transparent возвращает изображение с альфа-каналом |
output_format | png, jpeg, webp | png | Для transparent нужен png или webp |
Поскольку значения по умолчанию — opaque и png, чтобы получить прозрачность, нужно явно передать background. output_format для PNG можно не указывать, но с ним намерение очевидно в логах. "background": "transparent" вместе с "output_format": "jpeg" недопустимо, потому что у JPEG нет альфа-канала; проверяйте эту комбинацию на своей стороне, чтобы она отсеивалась до отправки.
Остальные поля работают как обычно: size (по умолчанию 1:1, любой пресет соотношения или собственный WIDTHxHEIGHT до 4,194,304 пикселей), resolution (1K или 2K) и необязательный callback_url. Полные правила полей — в справочнике API.
Тела запросов
Прозрачный PNG через MAI Image 2.7 API
Квадратный стикер 1K на Flash с теми же настройками полей, что и в нашем измеренном прогоне (промпт — пример):
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-flash",
"input": {
"prompt": "A cute cartoon sticker of a smiling coffee cup with a thick white outline, centered, no background",
"size": "1:1",
"resolution": "1K",
"background": "transparent",
"output_format": "png"
}
}'
Прозрачный логотип в WebP
Пример из документации PoYo, на флагмане:
{
"model": "mai-image-2.7",
"input": {
"prompt": "A flat vector logo of a red fox head, clean edges, no background",
"background": "transparent",
"output_format": "webp"
}
}
WebP тоже хранит альфа-канал и обычно даёт файлы меньше, чем PNG, что удобно для веб-страниц. PNG — более надёжный выбор для печати и дизайн-инструментов, которые ожидают именно его.
Оба запроса возвращают task_id. Опрашивайте GET https://api.poyo.ai/api/generate/status/{task_id}, пока status не станет finished, затем скачайте data.files[0].file_url. В руководстве по MAI Image 2.7 API есть полный цикл опроса.
Замер: прозрачный стикер в день запуска
Команда PoYo выполнила это в продакшн-API PoYo 19 ноября 2026 года:
| Параметр | Значение |
|---|---|
| Модель | mai-image-2.7-flash |
| Поля | size: "1:1", resolution: "1K", background: "transparent", output_format: "png" |
| Результат | PNG 1024x1024, RGBA |
| Фон | Настоящий альфа-канал: полностью прозрачно вокруг объекта |
| Стоимость по текущим ставкам | 2.062 кредита (около $0.0103) |
| Время | Около 42 с, от отправки до результата при опросе каждые несколько секунд |
Расчётная оценка: 1024x1024 — это около 1,024 выходных токенов по 2,000 кредитов за 1M, то есть 2.048 кредита; оставшиеся 0.014 кредита соответствуют примерно 40 токенам промпта по 350 кредитов за 1M. Иными словами, прозрачное изображение тарифицировано как любое другое изображение того же размера. Надбавки за прозрачность в прайс-листе нет.
Проверьте альфа-канал в коде
Не доверяйте расширению файла: прежде чем изображение попадёт в вашу библиотеку материалов, убедитесь, что в скачанном файле действительно есть прозрачные пиксели. С Pillow:
import io
import requests
from PIL import Image
def check_transparency(file_url):
data = requests.get(file_url, timeout=60).content
img = Image.open(io.BytesIO(data))
if img.mode != "RGBA":
img = img.convert("RGBA")
alpha = img.getchannel("A")
lo, hi = alpha.getextrema()
clear = sum(1 for a in alpha.getdata() if a == 0)
share = clear / (img.width * img.height)
print(img.size, img.mode, "alpha range", (lo, hi), f"{share:.0%} fully transparent")
return lo == 0 and share > 0.05
Результат с lo == 0 и заметной долей полностью прозрачных пикселей означает пригодную вырезку. Картинка с нарисованной «шахматкой» показала бы lo == 255: все пиксели непрозрачные. Подбирайте порог под свои материалы: у иллюстрации на весь кадр пустого места меньше, чем у иконки по центру.
Промпты для чистых вырезок
Альфа-каналом занимается модель; но то, насколько легко отделить объект, по-прежнему определяет промпт.
- Укажите, что объект один. Пример из документации PoYo заканчивается на «clean edges, no background». Пример Microsoft в Foundry для прозрачного изображения использует «full body, centered, no shadow».
- Избегайте слов, описывающих сцену. «On a table», «in a studio» или «with a shadow» просят то, что находится за пределами объекта.
- Для стикеров просите обводку. Толстая белая граница хорошо смотрится и на светлом, и на тёмном фоне.
- Берите текст в кавычки. Если в материале есть слово или текст логотипа, заключите его в кавычки, как документация рекомендует для текста на изображении.
Стоимость прозрачных материалов в больших объёмах
Выходные токены зависят только от числа пикселей, поэтому прозрачность стоит столько же, сколько непрозрачный вывод. Стоимость выходных токенов за изображение:
| Размер | MAI Image 2.7 | MAI Image 2.7 Flash |
|---|---|---|
1024x1024 (1:1, 1K) | 6.96 кредита ($0.0348) | 2.05 кредита ($0.0102) |
2048x2048 (1:1, 2K) | 27.85 кредита ($0.1393) | 8.19 кредита ($0.0410) |
При измеренных 2.062 кредита за стикер на Flash 1,000 стикеров обойдутся примерно в 2,062 кредита, около $10.31. Используйте Flash для наборов иконок и вырезок для каталогов, а MAI Image 2.7 — когда отдельный материал, например логотип бренда или главный снимок товара, должен получиться как можно лучше. Подробнее — в статье о ценах и сравнении Flash и 2.7.
Настройки для типичных задач с прозрачными материалами
| Задача | Модель | size / resolution | output_format |
|---|---|---|---|
| Стикеры для чатов и приложений в больших объёмах | mai-image-2.7-flash | 1:1, 1K | png или webp |
| Иконки и иллюстрации для сайтов | mai-image-2.7-flash | 1:1, 1K | webp |
| Вырезки товаров для e-commerce | mai-image-2.7 | 1:1 или 3:4, 2K | png |
| Логотип бренда для печати и презентаций | mai-image-2.7 | 1:1, 2K | png |
| Широкий элемент баннера поверх hero-изображения | mai-image-2.7 | Собственный, например 3072x1344 | webp |
Это отправные точки, а не правила: в каждой строке используются только документированные поля, так что задачу можно перенести между уровнями или размерами, не меняя ничего другого в запросе. Запускайте проверку альфа-канала на первой партии каждого нового типа задач.
Правка с прозрачным результатом
Схема также допускает background: "transparent" вместе с image_urls, например чтобы превратить фото товара в вырезку или изменить стиль существующего стикера с сохранением альфа-канала. Эту комбинацию мы пока не измеряли, поэтому протестируйте её на нескольких своих изображениях и запустите проверку альфа-канала выше, прежде чем полагаться на неё в продакшне.
Часто задаваемые вопросы
Как получить прозрачный фон в MAI Image 2.7 API?
Передайте "background": "transparent" и "output_format": "png" (или "webp") внутри input. По умолчанию возвращается непрозрачный PNG.
Может ли MAI Image 2.7 API вернуть прозрачный JPEG?
Нет. У JPEG нет альфа-канала, поэтому для transparent нужен PNG или WebP.
Поддерживает ли MAI Image 2.7 Flash прозрачный фон?
Да. Наш тест в день запуска на mai-image-2.7-flash вернул PNG 1024x1024 RGBA с полностью прозрачным фоном за 2.062 кредита по текущим ставкам.
Стоит ли прозрачный фон дороже в MAI Image 2.7 API? Нет. Он тарифицируется по тем же ставкам за текст, ввод изображений и выходные токены, что и любое другое изображение того же размера.
Может ли MAI Image 2.6 создавать прозрачные PNG? Нет. Прозрачность появилась в MAI Image 2.7. Остальные изменения полей — в статье MAI Image 2.7 API vs MAI Image 2.6 API.