how-tos

Прозрачный фон в MAI Image 2.7 API: материалы PNG и WebP

Poyo.ai Team
7 min read
Share:

Прозрачные материалы PNG и WebP из MAI Image 2.7 API

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 такой опции нет.

Два поля

ПолеЗначенияПо умолчаниюПравило
backgroundopaque, transparentopaquetransparent возвращает изображение с альфа-каналом
output_formatpng, jpeg, webppngДля 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.7MAI 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 / resolutionoutput_format
Стикеры для чатов и приложений в больших объёмахmai-image-2.7-flash1:1, 1Kpng или webp
Иконки и иллюстрации для сайтовmai-image-2.7-flash1:1, 1Kwebp
Вырезки товаров для e-commercemai-image-2.71:1 или 3:4, 2Kpng
Логотип бренда для печати и презентацийmai-image-2.71:1, 2Kpng
Широкий элемент баннера поверх hero-изображенияmai-image-2.7Собственный, например 3072x1344webp

Это отправные точки, а не правила: в каждой строке используются только документированные поля, так что задачу можно перенести между уровнями или размерами, не меняя ничего другого в запросе. Запускайте проверку альфа-канала на первой партии каждого нового типа задач.

Правка с прозрачным результатом

Схема также допускает 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.

Share: