MAI-Image 2.6: генерация и редактирование изображений

Обзор

MAI-Image 2.6 — это собственная модель генерации изображений от Microsoft AI, выпущенная 2026-09-04 и доступная в режиме public preview на платформе Microsoft Foundry. На момент запуска она занимала 2-е место как по генерации изображений по тексту (text-to-image), так и по редактированию изображений на 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, и подходит для высоконагруженных рабочих процессов в продакшене

Особенности: великолепный рендеринг китайского текста (вывески магазинов, вертикальные парные надписи и рукописный текст отображаются с точностью до иероглифа), высокоточное редактирование (изменяется только запрошенная область; остальная часть сохраняется пиксель-в-пиксель), произвольный холст с помощью width + height (разрешением до 1536×1536) и фиксированная цена за изображение независимо от размера. Генерация изображения 1024×1024 занимает около 17 с на Flash и около 30 с на 2.6.

📌 Три вещи, которые нужно знать перед началом работы

Поддерживаются только два эндпоинта: /v1/images/generations (text-to-image, JSON) и /v1/images/edits (редактирование, multipart/form-data). /v1/chat/completions и /v1/responses не поддерживаются и возвращают ошибку 404.
Не передавайте response_format, seed или negative_prompt. Все три параметра сразу вызовут ошибку 400. Ответ всегда возвращается в формате data[0].b64_json (PNG).
Задавайте размер с помощью width + height, а не size. На эндпоинте text-to-image параметр size игнорируется без предупреждения, и вы всегда получаете 1024×1024.

Все API для работы с изображениями являются синхронными: асинхронный ID задачи отсутствует. При разрыве соединения клиентом результат будет потерян, но запрос всё равно тарифицируется. Установите для этой модели достаточно большой таймаут. См. Основы работы с Image API и рекомендации.

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

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

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

Загрузка эталонного изображения с инструкцией; поддерживается объединение двух изображений. Включает Playground.

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

Если вы ведете разработку с помощью Codex / Claude Code / Cursor, скопируйте приведенный ниже prompt в агент. Сначала агент загрузит текстовую версию этой страницы (добавьте .md к любому URL документации), а затем напишет код под ваш стек технологий. В нем подробно описаны типичные ошибки: таймауты, три параметра, возвращающие ошибку 400, width/height вместо size, а также редактирование только через загрузку файлов.

Поручите ИИ-агенту для написания кода выполнить интеграцию или отладку генерации текста в изображение и редактирования изображений с помощью MAI-Image 2.6. Скопируйте и вставьте это в Codex, Claude Code, Cursor и т. д.

От чего защищает этот prompt

Требование	Предотвращенная ошибка
Удалить `response_format`	Наиболее распространенный явно заданный параметр в перенесенном коде. Его передача возвращает 400 и приводит к сбою всего пакета
`width` / `height` вместо `size`	`size` молча игнорируется при генерации текста в изображение. Вы ожидаете 1536×1024, а получаете квадрат 1024×1024
Загрузка только через файл для редактирования	Передача URL изображения или base64 JSON по стандарту OpenAI возвращает 400
`image` + `image2` для двух изображений	Форма с несколькими изображениями в OpenAI SDK отправляет `image[]`, что приводит к ошибке
Никаких chat / responses	Чат-клиенты отправляют chat-запросы для любого имени модели, что здесь вернет 404
Щедрые таймауты под каждую модель	За отключенные запросы плата все равно взимается. См. Основные сведения и лучшие практики по работе с Image API

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

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

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

Тарификация за изображение

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

Доступ откуда угодно

Не требуется аккаунт 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: цвет чайника изменен с кремового на кобальтово-синий, всё остальное без изменений

Тарифы

Модель	Позиционирование	Цена APIYI	Тарификация
`MAI-Image-2.6`	Флагман, приоритет качества	$0.12 / изображение	За изображение, любой размер
`MAI-Image-2.6-Flash`	Быстрая, приоритет пропускной способности	$0.06 / изображение	За изображение, любой размер

Цены на модели могут меняться; таблица выше носит исключительно справочный характер, а актуальные данные всегда указаны на вкладке Цены на модели в верхней навигации: Цены на модели.

Примечания по тарификации

За изображение, независимо от размера: 768×768 и 1536×1536 стоят одинаково, а длина prompt не влияет на цену.
Редактирование стоит столько же, сколько генерация по тексту: редактирование одного изображения и совмещение двух изображений тарифицируются как одно изображение каждое; 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. При больших пакетных нагрузках заранее обратитесь в службу поддержки.

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

Параметр	Характеристика
ID моделей	`MAI-Image-2.6`, `MAI-Image-2.6-Flash` (чувствительны к регистру)
Эндпоинты	`/v1/images/generations` (JSON), `/v1/images/edits` (multipart)
Параметры размера	`width` + `height`, целые числа, всегда вместе
Диапазон размеров	Каждая сторона ≥ 768; ширина × высота ≤ 2 359 296 (= 1536×1536); округляется в меньшую сторону до кратных 16
Размер по умолчанию	1024×1024
Формат вывода	PNG (RGB), только `b64_json`, около 1,5–1,7 МБ при 1024×1024
Изображений на запрос	Text-to-image: всегда 1; `n` работает на эндпоинте редактирования
Референсные изображения	Загрузка файлов на эндпоинте редактирования, до 2 (`image` + `image2`)
Inpainting по маске	❌ Не поддерживается
`seed` / `negative_prompt`	❌ Возвращают 400
Потоковая передача	❌ Не поддерживается
Задержка (1024×1024)	Flash P50 около 17 с, 2.6 P50 около 30 с
Рекомендуемый клиентский таймаут	Flash ≥ 120 с, 2.6 ≥ 180 с

Эндпоинты

Функция	Метод	Путь	Content-Type
Генерация изображений по тексту	`POST`	`/v1/images/generations`	`application/json`
Редактирование изображений	`POST`	`/v1/images/edits`	`multipart/form-data`

❌ Чат-эндпоинты не поддерживаются/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:

request Content-Type isn't multipart/form-data

Загружайте локальный файл напрямую с помощью -F "[email protected]". Хостинг изображений не требуется. Полные примеры см. в разделе API редактирования изображений.

Основной домен — https://api.apiyi.com, резервный домен — https://b.apiyi.com.

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

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

Правило	Подробности
Всегда вместе	Передача только одного возвращает 400
Минимум	Каждая сторона не менее 768; 767 возвращает 400 `'width' must be at least 768 pixels`
Ограничение площади	ширина × высота ≤ 2,359,296; 1600×1600 возвращает 400 `exceeds the maximum of 2359296`
Округление	Значения, не кратные 16, округляются в меньшую сторону: 1000×1000 → 992×992, 1024×1023 → 1024×1008
Соотношение сторон	Без ограничений; 3072×768 (баннер 4:1) работает

Распространенные размеры холста (все в пределах ограничения площади):

Назначение	`width` × `height`
Квадрат	1024×1024 / 1536×1536
Альбомная ориентация 3:2	1536×1024
Портретная ориентация 2:3	1024×1536
Альбомная ориентация 16:9	1792×1008
Портретная ориентация 9:16	1008×1792
Баннер 4:1	3072×768

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

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

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

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

HTTP	code / message	Значение	Что делать
`400`	`unsupported_request_value`	Размер вне допустимого диапазона, неверный тип или `width`/`height` не переданы вместе	Исправьте в соответствии с ограничением в сообщении; не повторяйте запрос
`400`	`invalid_request`: `Invalid parameters: xxx`	Переданы `response_format` / `seed` / `negative_prompt`	Удалите это поле
`400`	`invalid_request`: `Prompt must be …`	`prompt` пусто или отсутствует	Добавьте prompt
`400`	`invalid_request`: `File must be attached in a form field with a name starting with 'image'`	Повторяющееся поле файла (`image[]`×2) или `mask` на эндпоинте редактирования	Используйте `image` + `image2`; маски не поддерживаются
`400`	`content_safety_violation`	Заблокировано модерацией контента	Измените prompt; повторные попытки не помогут
`400`	`request Content-Type isn't multipart/form-data`	На эндпоинт редактирования отправлен JSON	Переключитесь на multipart-загрузку файлов
`404`	`Requested path is not found`	Запрос отправлен в chat / responses	Используйте Images API
`500`	`image is required`	В запросе на редактирование отсутствует поле файла изображения	Убедитесь, что поле файла называется `image`
`503`	`no available channels`	Неверный регистр имени модели (например, только строчные буквы)	Используйте `MAI-Image-2.6` / `MAI-Image-2.6-Flash`

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

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

Почему при передаче response_format возвращается 400?

Эта серия возвращает только b64_json и не принимает параметр response_format. Даже "b64_json" возвращает 400 Invalid parameters: response_format.В коде, перенесённом с gpt-image / DALL·E, он часто задаётся явно. Удалите его; изображение по-прежнему будет в data[0].b64_json. То же самое относится к seed и negative_prompt.

Я указал size: 1536x1024, почему результат всё равно квадратный?

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

Можно ли редактировать с использованием URL изображения?

Нет. Эндпоинт редактирования принимает только загрузку файлов через multipart/form-data. Передача URL, data URI или строки base64 в качестве image вернёт ошибку 400.Если у вас есть только URL, сначала скачайте файл на свой сервер, а затем загрузите его:

import requests
img = requests.get("https://example.com/photo.jpg", timeout=30).content
files = {"image": ("photo.jpg", img, "image/jpeg")}

Как отправить два референсных изображения? Почему не работает OpenAI SDK?

Назовите поле второго изображения image2:

curl -X POST "https://api.apiyi.com/v1/images/edits" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=MAI-Image-2.6" \
  -F "prompt=Place the person from image 2 into the scene in image 1" \
  -F "[email protected]" \
  -F "[email protected]"

Метод client.images.edit(image=[f1, f2]) из OpenAI SDK отправляет оба файла как image[]. Эта серия не принимает повторяющиеся поля файлов и возвращает ошибку 400. Редактирование одиночного изображения с помощью SDK работает корректно.

Поддерживается ли inpainting по маске?

Нет. Поле mask вернёт ошибку 400. Для локальных правок опишите нужную область в prompt, например: «Только сделай чайник синим, всё остальное оставь точно таким же». По результатам наших тестов модель точно следует подобным ограничениям.

Можно ли использовать его в Cherry Studio / LobeChat?

Не рекомендуется. Эти чат-клиенты используют /v1/chat/completions, который возвращает 404 для этой серии. Используйте инструмент с поддержкой OpenAI Images API или вызывайте его напрямую с помощью примеров кода из этой документации.

Сколько изображений возвращается за один запрос?

Генерация изображений по тексту всегда возвращает 1. Какое бы значение n вы ни передали, вы получите и оплатите 1 изображение. Для получения большего количества отправляйте параллельные запросы.На эндпоинте редактирования n работает: n=2 возвращает 2 изображения и тарифицируется как 2.

Можно ли сопоставить тарификацию с количеством token в usage?

Нет. usage.prompt_tokens всегда равно 1000 × количество изображений, а output_tokens всегда равно 0; это плейсхолдеры. Эта серия тарифицируется поштучно за изображение, а данные в консоли APIYI являются определяющими.

Насколько строга модерация? Как выглядит блокировка?

В этой серии используется официальная политика безопасности контента Microsoft, которая достаточно строгая: реальные знаменитости, жестокость (gore), известные персонажи с авторскими правами (например, Disney) и нагота блокируются.При блокировке возвращается 400 content_safety_violation с указанием конкретной причины в сообщении. Блокировки на уровне prompt обычно возвращаются в течение 5–8 с; некоторые применяются уже после генерации и занимают примерно столько же времени, сколько создание обычного изображения. Повторный запрос с тем же prompt не поможет — перефразируйте его.

Поддерживается ли потоковая передача?

Нет. Вызывайте его как обычный синхронный запрос и ожидайте полного ответа.

Возникает ошибка 503 no available channels?

Наиболее частая причина — неправильный регистр имени модели. Имя должно быть строго MAI-Image-2.6 или MAI-Image-2.6-Flash; mai-image-2.6-flash возвращает 503.

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

API Text-to-Image MAI-Image 2.6 - справочник по API с Playground
API редактирования изображений MAI-Image 2.6 - редактирование по референсному изображению и объединение двух изображений
Основы и лучшие практики Image API - таймауты, обрывы соединения, сжатие
Бонусная акция при пополнении

Основы

Базовый API

Image API (официальный)

Video API (официальный)

API мультимодального понимания

Генерация текста

Audio API (официальный)

Поиск и безопасность

MAI-Image 2.6: генерация и редактирование изображений

Обзор

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

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

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

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

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

Тарификация за изображение

Доступ откуда угодно

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

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

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

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

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

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

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

Тарифы

Группы и tokens

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

Эндпоинты

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

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

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

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

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

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

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

​Обзор

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

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

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

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

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

Тарификация за изображение

Доступ откуда угодно

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

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

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

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

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

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

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

​Тарифы

​Группы и tokens

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

​Эндпоинты

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

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

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

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

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

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

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

Обзор

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

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

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

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

Тарифы

Группы и tokens

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

Эндпоинты

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

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

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

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

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

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

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