Microsoft AI: MAI-Image-2.5 Pro

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

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

О модели

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

Microsoft AI MAI-Image-2.5 Pro — версия серии изображений 2.5, ориентированная на точность воспроизведения. Она генерирует изображения по заданиям на естественном языке и выполняет направленные правки существующих материалов. Microsoft называет главные визуалы, подробное редактирование и точный текст внутри изображения ключевыми задачами; сравнение моделей выделяет постоянство предметов, персонажей, материалов и пространственных связей в сложных композициях. Итоговый материал — картинка для дизайна или производства, например ключевое товарное изображение или тщательно выстроенная редакционная сцена.

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

Для товаров и персонажей предоставьте визуальную идентичность, которая должна пережить правку. Microsoft описывает постоянство предметов в сложных сценах и персонажей при разных видах и моментах как сильные стороны Pro. Укажите узнаваемые черты предмета или человека и изменяемый аспект сцены. Например, сохраните силуэт куртки и детали застёжки, поместив персонажа на другой фон. Полезная проверка сопоставляет сохранённые детали с исходным референсом; визуальная привлекательность сама не доказывает точное совпадение.

Интерфейс редактирования разработчика принимает до пяти JPEG или PNG. Разделите роли в задании: товар, человек, обстановка или визуальная обработка. Редактирование включает удаление и замену предметов, изменение атрибутов, перерисовку области, адаптацию макета, обновление текста и устранение артефактов. Для локальной правки опишите цель и сохраняемое окружение. При более существенной перестановке объясните устройство композиции после изменения, давая модели согласованную пространственную цель.

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

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

Руководство сервинга задаёт максимум контекста промпта 32 000 токенов и возвращает данные PNG для генерации и редактирования. Точная каталожная страница Pro отдельно указывает окно 131.072K и 4 096 выходных токенов. Это опубликованные количества токенов с собственными областями каталога или сервинга; практическая подготовка запроса изображения следует пределам промпта и пикселей сервинга. Сохраняйте изображение, референсы и задание как единую запись правки. Проверяйте сам результат на подробные ограничения идентичности, материалов и геометрии, ради которых выбран Pro.

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

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

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

microsoft/mai-image-2.5-pro

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

Начало

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

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

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

Входные данные: text, image
Результат: image

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения microsoft/mai-image-2.5-pro	По умолчанию—
Поле`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.884736 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

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-pro', '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-pro

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

/v1/images

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

microsoft/mai-image-2.5-pro

FAQ · Microsoft AI: MAI-Image-2.5 Pro

Какие входные данные и результаты доступны?: POST /v1/images/generations · microsoft/mai-image-2.5-pro: text, image → image
Какие поля использует запрос?: POST /v1/images/generations · microsoft/mai-image-2.5-pro: model, prompt, aspect_ratio, n, input_references, provider
Какие ограничения действуют?: POST /v1/images/generations · microsoft/mai-image-2.5-pro: n.minimum: 1; n.maximum: 1

Microsoft AI: MAI-Image-2.5 Pro