Microsoft AI: 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

О модели

Описание раскрывает возможности модели. Доступные в 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

Microsoft AI /microsoft/mai-image-2.5

Начало

Допустимые входные данные: Текст · Картинки
Результаты: Картинки

Доступно в 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 резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

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

Ailoot Ultra · Картинки

curl

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}

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

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

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

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

/v1/images

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

microsoft/mai-image-2.5

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

Microsoft AI: MAI-Image-2.5