Перейти к основному содержанию

Обзор

MAI-Image 2.6 — это собственная модель генерации изображений от Microsoft AI, выпущенная 2026-09-04 и доступная в режиме public preview на Microsoft Foundry. На момент запуска она занимала 2-е место как по генерации изображений по тексту, так и по редактированию изображений на Arena, а также 1-е место по редактированию изображений на Artificial Analysis (по состоянию на 2026-09-04, согласно анонсу Microsoft). APIYI предоставляет два варианта через официальный канал Microsoft. Оба используют одинаковые эндпоинты и параметры:
  • MAI-Image-2.6: флагманская версия, настроенная на максимальное качество и точность
  • MAI-Image-2.6-Flash: быстрая версия. По заявлению Microsoft, она генерирует изображения в 2,8 раза быстрее, чем GPT-Image-2-Medium, и подходит для высоконагруженных рабочих процессов в production
Главные особенности: превосходный рендеринг китайского текста (вывески магазинов, вертикальные парные надписи и рукописный текст передаются с точностью до иероглифа), высокоточное редактирование (изменяется только запрошенная часть, остальное остается попиксельно идентичным), произвольный холст с помощью width + height (с площадью до 1536×1536), а также фиксированная цена за изображение независимо от размера. Генерация изображения размером 1024×1024 занимает около 17 с на Flash и около 30 с на 2.6.
📌 Три вещи, которые нужно знать перед началом работы
  1. Поддерживаются только два эндпоинта: /v1/images/generations (генерация по тексту, JSON) и /v1/images/edits (редактирование, multipart/form-data). /v1/chat/completions и /v1/responses не поддерживаются и возвращают 404.
  2. Не передавайте response_format, seed или negative_prompt. Все три параметра сразу возвращают 400. Ответ всегда приходит в формате data[0].b64_json (PNG).
  3. Задавайте размер с помощью width + height, а не size. На эндпоинте генерации по тексту size игнорируется без предупреждения, и вы всегда получаете 1024×1024.
Все API изображений являются синхронными: идентификатор асинхронной задачи (async task ID) отсутствует. При отключении клиента результат будет потерян, но запрос все равно тарифицируется. Установите для этой модели увеличенный таймаут. См. раздел Главное об API изображений и лучшие практики.

API генерации изображений по тексту

Генерация изображений по текстовому prompt с интерактивным Playground.

API редактирования изображений

Загрузка от 1 до 5 референсных изображений вместе с инструкцией, с объединением нескольких изображений. Включает Playground.

Доверьте интеграцию AI-агенту

Скопируйте этот prompt и вставьте его в Codex / Claude Code / Cursor

Агент сначала запросит текстовую версию этой страницы (добавьте .md к любому URL документации), а затем напишет код под ваш стек. Типичные подводные камни подробно описаны: таймауты, три параметра, возвращающие 400, width/height вместо size и редактирование исключительно через загрузку файлов.

Интегрируйте (или отладьте) генерацию изображений по тексту и редактирование изображений Microsoft MAI-Image 2.6 в этом проекте.

Перед написанием кода изучите документацию: запросите https://docs.apiyi.com/en/api-capabilities/mai-image/overview.md для получения текстовой версии этой страницы. Для подробных параметров добавьте .md к text-t …

  1. Названия моделей: флагманская MAI-Image-2.6, быстрая версия MAI-Image-2.6-Flash. Названия моделей чувствительны к регистру. Имя, написанное только строчными буквами, возвращает 503, что выгляд …

Всего 11 требований. Используйте кнопку ниже, чтобы скопировать prompt целиком.

Почему стоит использовать MAI-Image 2.6 на APIYI

Официальный канал Microsoft

Предоставляется через официальный канал Microsoft. Модель полностью аналогична одноименной модели в Microsoft Foundry. Стандартные эндпоинты /v1/images/generations и /v1/images/edits с форматом ответов, как в OpenAI Images API.

Оплата за изображение

Провайдер выполняет тарификацию по tokens, поэтому изображения большего размера стоят дороже. APIYI взимает фиксированную цену за изображение независимо от размера: 768×768 и 1536×1536 стоят одинаково, а редактирование с 1 или 5 референсными изображениями также стоит столько же, что позволяет рассчитывать бюджет на каждое изображение.

Доступ из любой точки

Аккаунт Azure или зарубежный сервер не требуются. Подключайтесь к api.apiyi.com напрямую из дата-центров, домашних сетей или зарубежных узлов, используя один ключ для всех моделей.

Полная линейка моделей

Сочетайте с GPT-Image-2, Nano Banana 2, Seedream и FLUX для различных сценариев использования.

Ключевые возможности

Отрисовка китайского текста

Китайские вывески магазинов, вертикальные парные надписи и рукописный текст на меловой доске получаются точными до иероглифа. Отлично подходит для постеров, изображений товаров и мерча

Высокоточное редактирование

«Сделай чайник кобальтово-синим» меняет только чайник; размерные метки и другие объекты остаются попиксельно идентичными

Пользовательский холст

Любая комбинация width + height с длинной стороной до 3072 (например, баннер 3072×768) и ограничением площади до 1536×1536

Два уровня скорости

Генерация 1024×1024 занимает около 17 с на Flash и около 30 с на 2.6; задержка остается стабильной при 10 параллельных запросах

Примеры результатов

Отрисовка китайского текста (MAI-Image-2.6-Flash, prompt запрашивал китайскую вывеску, приветствующую посетителей APIYI): вывеска, фонари, вертикальные парные надписи и меловая доска содержат четкий и разборчивый китайский текст.
Отрисовка китайского текста в MAI-Image-2.6-Flash: традиционная чайная с приветственной вывеской на китайском языке
Редактирование по изображению-референсу (MAI-Image-2.6-Flash, инструкция «Замени глазурь чайника на глубокий кобальтово-синий, всё остальное оставь без изменений»): оригинал слева, результат справа. Цвет меняет только чайник; размерные метки и остальные объекты остаются нетронутыми.
Пример редактирования в MAI-Image-2.6-Flash: цвет чайника изменен с кремового на кобальтово-синий, всё остальное без изменений

Тарифы

Цены на модели могут меняться; приведенная выше таблица носит справочный характер, а официальная информация указана во вкладке Цены на модели в верхнем меню: Цены на модели.
Примечания по тарификации
  • За изображение, независимо от размера: разрешения 768×768 и 1536×1536 стоят одинаково, а длина prompt не влияет на стоимость.
  • Редактирование стоит столько же, сколько генерация по тексту: тарифицируются итоговые изображения, при этом 1 или 5 референсных изображений стоят одинаково; n=2 на эндпоинте редактирования тарифицируется как 2 изображения.
  • Запросы, завершившиеся ошибкой 400 (модерация или неверные параметры), не создают изображений.
  • Не сверяйте с полем usage в ответе: prompt_tokens всегда равно 1000 × количество изображений и является заполнителем. Официальные данные отображаются в счете в консоли.
  • Суммируется с акцией бонусов при пополнении.

Группы и tokens

Эта серия входит в группу Default. Её может вызывать любой вновь созданный token; подавать заявку не требуется.
Режим тарификации token: для этой серии подходят как Pay-as-you-go Priority, так и Per-request. Мы рекомендуем Pay-as-you-go Priority, чтобы один и тот же token работал и с моделями платформы, тарифицируемыми по tokens.Частота запросов: держите нагрузку на один ключ в пределах 50 RPM. При больших пакетных нагрузках заранее обратитесь в службу поддержки.

Технические характеристики

Эндпоинты

❌ Чат-эндпоинты не поддерживаются/v1/chat/completions и /v1/responses возвращают 404 Requested path is not found для этой серии. Чат-клиенты, такие как Cherry Studio и LobeChat, отправляют чат-запросы ко всем моделям из списка, поэтому не выбирайте MAI-Image в этих клиентах. Используйте инструмент с поддержкой Images API или вызывайте его из собственного кода.
✅ Эндпоинт редактирования принимает только загрузку файлов через multipartОтправка JSON (с image в виде URL, data URI или необработанного base64) на /v1/images/edits возвращает 400:
Загружайте локальный файл напрямую с помощью -F "[email protected]". Хостинг изображений не требуется. Полные примеры см. в разделе API редактирования изображений.
Основной домен — https://api.apiyi.com, резервный домен — https://b.apiyi.com.

Ключевые параметры

width и height (размер вывода)

Распространенные размеры холста (все в пределах ограничения площади):
size ведет себя по-разному на двух эндпоинтах: в text-to-image он молча игнорируется (всегда 1024×1024), тогда как на эндпоинте редактирования он применяется. Чтобы избежать путаницы, используйте width + height на обоих эндпоинтах.

n (количество изображений)

  • Text-to-image: n не действует. Передача 2, 4 или 10 по-прежнему возвращает 1 изображение (и тарифицируется как 1). Для получения большего количества отправляйте параллельные запросы.
  • Редактирование: n работает. n=2 возвращает 2 изображения, которые тарифицируются как 2.

Рекомендации

1

Выбирайте вариант под конкретную задачу

Пакетная генерация или чувствительные к задержке задачи → MAI-Image-2.6-Flash. Главные постеры, сложные композиции или строгие требования к качеству → MAI-Image-2.6. Параметры идентичны, поэтому переключение требует лишь изменения имени модели.
2

Заключайте в кавычки текст, который нужно отобразить

Поместите любой текст, который должен появиться на изображении, в кавычки и укажите, где он должен располагаться, например вывеска с надписью «Grand Opening». Модель очень точно воспроизводит текст в кавычках.
3

Указывайте «оставьте всё остальное без изменений» при редактировании

Формулируйте инструкции наподобие «Сделай чайник кобальтово-синим, всё остальное оставь точно таким же», чтобы сохранить как можно больше деталей оригинала.
4

Изменение холста меняет композицию изображения

Если вы передадите width / height с соотношением сторон, отличным от оригинала, модель перестраивает композицию сцены, а не обрезает её и не добавляет поля. Для точечного редактирования не указывайте размер: тогда соотношение сторон результата будет соответствовать оригиналу с округлением до кратных 16 (например, входное изображение 1344×756 → результат 1360×768).
5

Нужно несколько изображений? Отправляйте параллельные запросы

Генерация «текст в изображение» возвращает одно изображение за вызов, поэтому для 4 изображений отправьте 4 параллельных запроса. В наших тестах при 10 параллельных запросах задержка соответствовала одиночным запросам.

Коды ошибок и повторные попытки

Совет клиенту: перечисленные выше ошибки 4xx / 500 детерминированы, поэтому повторять запросы бессмысленно — вместо этого настройте оповещения о них. Повторять попытки стоит только при сетевых таймаутах и 429, используя экспоненциальную задержку и максимум 3 попытки. Помните, что запросы, прерванные по клиентскому таймауту, все равно тарифицируются, поэтому сначала увеличьте таймаут.

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

Эта серия возвращает только b64_json и не принимает параметр response_format. Даже "b64_json" возвращает 400 Invalid parameters: response_format.Код, перенесенный с gpt-image / DALL·E, часто задает его явно. Удалите его; изображение по-прежнему будет в data[0].b64_json. То же самое относится к seed и negative_prompt.
Эндпоинт text-to-image не считывает size. Он просто игнорирует его и генерирует стандартное разрешение 1024×1024. Используйте вместо этого "width": 1536, "height": 1024.На эндпоинте редактирования size работает, но для единообразия используйте width + height в обоих случаях.
Нет. Эндпоинт редактирования принимает только загрузку файлов multipart/form-data. Передача URL, data URI или строки base64 в качестве image вернет ошибку 400.Если у вас есть только URL, сначала скачайте его на свой сервер, а затем загрузите:
Да, от 1 до 5 изображений (с 2026-10-07) по той же цене, что и одно изображение.
  • Как: повторяйте поле image[], curl -F "image[][email protected]" -F "image[][email protected]"; в OpenAI SDK передайте список client.images.edit(image=[f1, f2])
  • Ссылки на изображения: они нумеруются как image 1, image 2, … в порядке загрузки, например: «Помести лису из image 2 в сцену из image 1, всё остальное в image 1 оставь без изменений»
  • Не используйте image + image2: возвращается 200, но второе изображение отбрасывается и используется только первое
  • Более 5 изображений вернет 400 at most 5 reference images are accepted for <model>
Полные примеры см. в API редактирования изображений.
Нет. Поле mask возвращает 400 <model> does not support mask edits. Для локальных изменений опишите область в prompt, например: «Сделай только чайник синим, всё остальное оставь точно таким же». По результатам наших тестов модель точно следует подобным ограничениям.
Не рекомендуется. Эти чат-клиенты используют /v1/chat/completions, который возвращает 404 для этой серии. Используйте инструмент с поддержкой OpenAI Images API или вызывайте его напрямую с помощью примеров кода из этой документации.
Text-to-image всегда возвращает 1. Какое бы значение n вы ни передали, вы получите и оплатите 1 изображение. Для получения большего количества отправляйте параллельные запросы.На эндпоинте редактирования n работает: n=2 возвращает 2 изображения и тарифицируется как 2.
Нет. usage.prompt_tokens всегда равен 1000 × количество изображений, а output_tokens всегда равен 0; это плейсхолдеры. Эта серия тарифицируется за изображение, и данные о списаниях в консоли APIYI являются определяющими.
В этой серии используется официальная политика безопасности контента Microsoft, которая довольно строгая: блокируются реальные знаменитости, сцены насилия и жестокости, известные персонажи с авторскими правами (например, Disney) и нагота.При блокировке возвращается 400 content_safety_violation с указанием конкретной причины в сообщении. Блокировки на уровне prompt обычно возвращаются в течение 5–8 с; некоторые применяются уже после генерации и занимают примерно столько же времени, сколько обычное изображение. Повторная отправка того же prompt не поможет; перефразируйте его.
Нет. Выполняйте обычный синхронный запрос и ожидайте полного ответа.
Наиболее частая причина — неверный регистр в имени модели. Имя должно быть строго MAI-Image-2.6 или MAI-Image-2.6-Flash; mai-image-2.6-flash возвращает 503.

Связанные документы