Source: https://ailoot.ai/models/ru/microsoft-mai-image-2-5/
Canonical: https://ailoot.ai/models/ru/microsoft-mai-image-2-5/
Language: ru

# Microsoft AI: MAI-Image-2.5

[Markdown](https://ailoot.ai/models/ru/microsoft-mai-image-2-5/index.md) · [JSON](https://ailoot.ai/models/ru/microsoft-mai-image-2-5/facts.json)

## [Microsoft AI: MAI-Image-2.5](https://ailoot.ai/models/ru/microsoft-mai-image-2-5/)

Microsoft AI MAI-Image-2.5 создаёт изображения по тексту и выполняет точечные правки предоставленных фотографий или дизайнов. Поддерживает изменение объектов и текста, устранение артефактов и правки с сохранением лиц, принимает до пяти визуальных референсов и выдаёт PNG. Карточка модели задаёт контекст 32K и результат до 1 048 576 пикселей.

- [**Ailoot Ultra · Картинки** `POST /v1/images/generations` `microsoft/mai-image-2.5`](https://ailoot.ai/models/ru/microsoft-mai-image-2-5/#method-0)

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

Microsoft AI MAI-Image-2.5 — версия семейства изображений 2.5 для общей генерации и управляемого редактирования. Карточка описывает диффузионную модель с flow matching, 20 миллиардами параметров без эмбеддингов, текстовым и графическим входом и контекстом 32K токенов. Она выдаёт изображения для концепций, портретов, товаров, иллюстраций и правок существующих дизайнов. Полезный первый выбор — нужна новая композиция или конкретное изменение материала, уже содержащего нужный объект.

Для генерации опишите главный объект, стиль, свет, точку обзора и расположение. Разработчик выделяет детальные согласованные изображения, отображение текста, товарные визуалы и следование промпту. Практическое задание иллюстрации для презентации может задавать роль объекта, визуальный акцент и объём пространства вокруг. Товарная концепция — материал, масштаб и отделку поверхности. Сохраняйте согласованность описания, чтобы предметы принадлежали одной сцене и световой схеме вместо сочетания несовместимых обработок.

Визуальное рассуждение этой версии касается структуры сцены, света, масштаба и пространственных связей. Разработчик приводит добавление объекта с подходящими перспективой и тенями как задачу редактирования. Например, поставьте маленький табурет рядом с верстаком, сохранив точку обзора и свет мастерской. При проверке сравните размер табурета, контакт с полом и соответствие тени остальным предметам. Даже локально убедительный объект должен подходить геометрии всего исходника.

Направленные правки включают удаление или замену предметов, изменение атрибутов, перерисовку области, адаптацию макета, обновление текста и устранение артефактов, например смаза движения. Предоставьте исходное изображение, назовите исправление и сохраняемые детали. Точечная правка фото может удалить отвлекающий предмет с фона, сохранив человека, кадрирование и передний план. Правка дизайна — обновить короткую строку с сохранением композиции. Сравнивайте весь результат с источником, а не только изменённую область.

Microsoft также выделяет постоянство лица при правках, включая смену позы, выражения или точки обзора. Используйте ясный референс сходства и задавайте изменение с сохранением узнаваемых черт. Текущее руководство принимает до пяти JPEG или PNG, позволяя разным референсам задавать человека, предмет, сцену или стиль. Назовите роли в промпте. При правке портрета проверьте лицо вместе с изменённой одеждой или фоном до завершения работы.

Карточка конкретной модели ограничивает результат общей площадью 1 048 576 пикселей, равной квадрату 1024×1024, и допускает сторону больше 1024 при сохранении площади. Руководство сервинга дополнительно требует обе стороны не менее 768 пикселей. Прямоугольник 1344×768 содержит 1 032 192 пикселя и удовлетворяет документированным площади и минимальным размерам. Полезный предел — произведение ширины на высоту, поэтому подготовьте форму размещения до запроса горизонтальной или вертикальной композиции.

В интерфейсе сервинга генерация и редактирование возвращают данные PNG. Родная карточка модели сообщает контекст 32K токенов, интерфейс — максимум контекста промпта 32 000 токенов. Отдельные 4 096 выходных токенов каталога — токеновый лимит, а не размер изображения. Сохраняйте эти области применения при организации подробного промпта и готовой картинки. Исходные материалы, сохраняемые особенности, правки и размер составляют полезную запись для дальнейших изменений вместе с PNG.

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

В семействе 2.5 Pro выделяет более высокую точность и стабильные отношения в насыщенных сценах, а Flash предназначен для более быстрой работы. Семейство 2.6 вводит больший предел площади, необязательную привязку к веб-источникам и выбор пропорций моделью. Обычная 2.5 сохраняет собственный процесс генерации и редактирования без поздних настроек. Выбирайте версию по сложной части реальной задачи и проверяйте готовый результат по этому заданию.

**Ailoot Ultra · Картинки** `POST /v1/images/generations` `microsoft/mai-image-2.5`

[`microsoft/mai-image-2.5`](https://ailoot.ai/models/ru/#m=microsoft%2Fmai-image-2.5&route=Ultra&caller=microsoft%2Fmai-image-2.5&fmt=images)

Microsoft AI /`microsoft/mai-image-2.5`

### Начало

Microsoft AI MAI-Image-2.5 создаёт изображения по тексту и выполняет точечные правки предоставленных фотографий или дизайнов. Поддерживает изменение объектов и текста, устранение артефактов и правки с сохранением лиц, принимает до пяти визуальных референсов и выдаёт PNG. Карточка модели задаёт контекст 32K и результат до 1 048 576 пикселей.

Допустимые входные данные

Текст · Картинки

Результаты

Картинки

### Доступно в Ailoot · входные данные и методы

**Ailoot Ultra · Картинки** `POST /v1/images/generations`

Входные данные

`text`, `image`

Результат

`image`

| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
| --- | --- | --- | --- | --- |
| Поле`model` | Тип`string` | ТребованиеОбязательно | Значения и ограничения microsoft/mai-image-2.5 | По умолчанию— |
| Поле`prompt` | Тип`string` | ТребованиеОбязательно | Значения и ограничения Минимальная длина: 1 | По умолчанию— |
| Поле`aspect_ratio` | Тип`string` | ТребованиеНеобязательно | Значения и ограничения 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto | По умолчанию— |
| Поле`n` | Тип`integer` | ТребованиеНеобязательно | Значения и ограничения Минимум: 1 Максимум: 1 | По умолчанию— |
| Поле`input_references` | Тип`array` | ТребованиеНеобязательно | Значения и ограничения Минимум элементов: 0 Максимум элементов: 1 | По умолчанию— |
| Поле`provider` | Тип`object` | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |

Параметры и жизненный цикл метода

| Параметр | Контракт |
| --- | --- |
| Параметр`content_type` | Контрактapplication/json |
| Параметр`required` | Контрактmodel, prompt |
| Параметр`material_types` | Контрактtext, image |

Жизненный цикл: `synchronous_result_then_owned_library`

`GET /v1/media/tasks/{task_id}` · Фактически возвращённый task\_id или запись в медиатеке

`GET /v1/media/assets/{asset_id}/content`

`GET /v1/media/assets`

`GET /v1/media/assets/{asset_id}`

### Тарифы

##### Как рассчитывается итоговая плата

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

Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.

Быстрый режим

Не указано При выборе быстрого режима

Режим flex

Не указано При выборе режима flex

Максимальная интенсивность рассуждений

Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)

#### Оценочные ставки для сравнения

#### Цены по конфигурациям

Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.

| Конфигурация | Шкала ставок | Прогноз количества | Плата |
| --- | --- | --- | --- |
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Прогноз количества— | Плата Вход · Входные токены · Оценка только для сравнения **—** / 1K токенов Выход · Выходные токены · Оценка только для сравнения **—** / 1K токенов Вход · Чтение кэша · Оценка только для сравнения **—** / 1K токенов Вход · Запись в кэш · Оценка только для сравнения **—** / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения **—** / 1K токенов |
| КонфигурацияОриентировочная стоимость генерации | Шкала ставок— | Прогноз количестваОценка для одной генерации | Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения **$0.385024** оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации. |

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. [Как работают резервирование и расчёт →](https://ailoot.ai/docs/ru/billing/reserve/)

### Примеры запросов

#### Ailoot Ultra · Картинки

curl

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'microsoft/mai-image-2.5', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
```

### Получить и сохранить результаты

#### Ailoot Ultra · Картинки

Загрузите каждое полученное изображение или сохраните его содержимое Base64

- `GET /v1/media/tasks/{task_id}`
- `GET /v1/media/assets/{asset_id}/content`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

Чтение другого содержимого

Читать существующие материалы, принадлежащие вам

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
```

##### Сохраняйте все готовые результаты

Сохраните каждое готовое изображение; загрузите содержимое по каждому полученному URL или декодируйте его содержимое Base64.

Сохраняйте полный ответ и заголовки, все фактические результаты, исходные возвращённые идентификаторы и все поля использования. Восстанавливайте исходную операцию без повторной отправки запроса создания.

##### Если нужно проверить исходный ответ

Сохраните возвращённый X-Client-Request-ID для сверки. Читайте только фактически возвращённые значения task\_id/asset\_id или собственную медиатеку; никогда не составляйте URL задачи из ID операции и никогда не отправляйте запрос создания повторно.

Поля ответа

| Поле | Тип |
| --- | --- |
| Поле`created` | Тип |
| Поле`data[].url` | Тип |
| Поле`data[].b64_json` | Тип |
| Поле`usage` | Тип |

### Псевдонимы

#### Псевдонимы моделей

**Ailoot Ultra** [`microsoft/mai-image-2.5`](https://ailoot.ai/models/ru/#m=microsoft%2Fmai-image-2.5&route=Ultra&caller=microsoft%2Fmai-image-2.5&fmt=images)

#### Псевдонимы путей метода

`/v1/images`

#### Связанные ID для вызова

[`microsoft/mai-image-2.5`](https://ailoot.ai/models/ru/#m=microsoft%2Fmai-image-2.5&route=Ultra&caller=microsoft%2Fmai-image-2.5&fmt=images)

FAQ · Microsoft AI: MAI-Image-2.5

Какие входные данные и результаты доступны?

`POST /v1/images/generations` · `microsoft/mai-image-2.5`: `text`, `image` → `image`

Какие поля использует запрос?

`POST /v1/images/generations` · `microsoft/mai-image-2.5`: `model`, `prompt`, `aspect_ratio`, `n`, `input_references`, `provider`

Какие ограничения действуют?

`POST /v1/images/generations` · `microsoft/mai-image-2.5`: `n.minimum`: `1`; `n.maximum`: `1`

Подключите Ailoot к Claude Code, OpenCode, Hermes или своему приложению.

## Компания и портфель её проектов

Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно.

## Покупайте токены со скидкой.

Скидка по подписке для регулярной работы. Промокоды — до 50% на покупку токенов.

Подписка

Выберите тариф со скидкой для своих регулярных запросов.

Промокод до 50%

Введите код при покупке. Цена пересчитается с учётом действующей акции.

Расходы в истории

Модель, токены и сумма сохраняются для каждого запроса.

[Выбрать подписку](https://ailoot.ai/docs/ru/billing/subscriptions/) · [Посмотреть цены моделей](https://ailoot.ai/models/ru/)

## Подключайте API к продукту, который вы продаёте.

SaaS, приложения и боты — по оферте и лицензионному договору Ailoot. Для перепродажи запросите реселлерскую лицензию.

Коммерческое приложение

Встраивайте генерацию текста, картинок, видео и звука в платные функции своего сервиса.

Лицензия для реселлера

Пришлите описание проекта и схему доступа. Запросите письменные условия использования и перепродажи.

Документы на сайте

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

[Запросить реселлерскую лицензию](mailto:support@ailoot.ai) · [Оферта и лицензионный договор](https://ailoot.ai/legal/offer?lang=ru)

## Ailoot · Компания и портфель её проектов





Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI.





Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно.





Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.
