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 сохраняет собственный процесс генерации и редактирования без поздних настроек. Выбирайте версию по сложной части реальной задачи и проверяйте готовый результат по этому заданию.
", "aboutText": "Microsoft AI MAI-Image-2.5 — версия семейства изображений 2.5 для общей генерации и управляемого редактирования. Карточка описывает диффузионную модель с flow matching, 20 миллиардами параметров без эмбеддингов, текстовым и графическим входом и контекстом 32K токенов. Она выдаёт изображения для концепций, портретов, товаров, иллюстраций и правок существующих дизайнов. Полезный первый выбор — нужна новая композиция или конкретное изменение материала, уже содержащего нужный объект.\n\nДля генерации опишите главный объект, стиль, свет, точку обзора и расположение. Разработчик выделяет детальные согласованные изображения, отображение текста, товарные визуалы и следование промпту. Практическое задание иллюстрации для презентации может задавать роль объекта, визуальный акцент и объём пространства вокруг. Товарная концепция — материал, масштаб и отделку поверхности. Сохраняйте согласованность описания, чтобы предметы принадлежали одной сцене и световой схеме вместо сочетания несовместимых обработок.\n\nВизуальное рассуждение этой версии касается структуры сцены, света, масштаба и пространственных связей. Разработчик приводит добавление объекта с подходящими перспективой и тенями как задачу редактирования. Например, поставьте маленький табурет рядом с верстаком, сохранив точку обзора и свет мастерской. При проверке сравните размер табурета, контакт с полом и соответствие тени остальным предметам. Даже локально убедительный объект должен подходить геометрии всего исходника.\n\nНаправленные правки включают удаление или замену предметов, изменение атрибутов, перерисовку области, адаптацию макета, обновление текста и устранение артефактов, например смаза движения. Предоставьте исходное изображение, назовите исправление и сохраняемые детали. Точечная правка фото может удалить отвлекающий предмет с фона, сохранив человека, кадрирование и передний план. Правка дизайна — обновить короткую строку с сохранением композиции. Сравнивайте весь результат с источником, а не только изменённую область.\n\nMicrosoft также выделяет постоянство лица при правках, включая смену позы, выражения или точки обзора. Используйте ясный референс сходства и задавайте изменение с сохранением узнаваемых черт. Текущее руководство принимает до пяти JPEG или PNG, позволяя разным референсам задавать человека, предмет, сцену или стиль. Назовите роли в промпте. При правке портрета проверьте лицо вместе с изменённой одеждой или фоном до завершения работы.\n\nКарточка конкретной модели ограничивает результат общей площадью 1 048 576 пикселей, равной квадрату 1024×1024, и допускает сторону больше 1024 при сохранении площади. Руководство сервинга дополнительно требует обе стороны не менее 768 пикселей. Прямоугольник 1344×768 содержит 1 032 192 пикселя и удовлетворяет документированным площади и минимальным размерам. Полезный предел — произведение ширины на высоту, поэтому подготовьте форму размещения до запроса горизонтальной или вертикальной композиции.\n\nВ интерфейсе сервинга генерация и редактирование возвращают данные PNG. Родная карточка модели сообщает контекст 32K токенов, интерфейс — максимум контекста промпта 32 000 токенов. Отдельные 4 096 выходных токенов каталога — токеновый лимит, а не размер изображения. Сохраняйте эти области применения при организации подробного промпта и готовой картинки. Исходные материалы, сохраняемые особенности, правки и размер составляют полезную запись для дальнейших изменений вместе с PNG.\n\nТворческий диапазон модели охватывает фотореалистичные и кинематографические изображения, портреты, товарные или брендовые концепции, дизайны с текстом и другие стили. Для этикетки или вывески задайте точные слова и проверьте написание в конечном размере показа. Узнаваемая фотографическая поверхность всё равно может содержать выдуманную деталь, несогласованное отражение или неточную надпись. Проверка следует требованиям дизайна: важны идентичность предмета, читаемость, пространственные связи и сохраняемая сцена. Отделяйте конкретное исправление от уже удавшихся изменений.\n\nВ семействе 2.5 Pro выделяет более высокую точность и стабильные отношения в насыщенных сценах, а Flash предназначен для более быстрой работы. Семейство 2.6 вводит больший предел площади, необязательную привязку к веб-источникам и выбор пропорций моделью. Обычная 2.5 сохраняет собственный процесс генерации и редактирования без поздних настроек. Выбирайте версию по сложной части реальной задачи и проверяйте готовый результат по этому заданию.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "3d57300a4dd9071fec71888eafcfa68a1f6ec2861273e601223ef0ff983728f8", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ru", "methods": [ { "html": "microsoft/mai-image-2.5Microsoft AI MAI-Image-2.5 создаёт изображения по тексту и выполняет точечные правки предоставленных фотографий или дизайнов. Поддерживает изменение объектов и текста, устранение артефактов и правки с сохранением лиц, принимает до пяти визуальных референсов и выдаёт PNG. Карточка модели задаёт контекст 32K и результат до 1 048 576 пикселей.
Описание раскрывает возможности модели. Доступные в 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 сохраняет собственный процесс генерации и редактирования без поздних настроек. Выбирайте версию по сложной части реальной задачи и проверяйте готовый результат по этому заданию.
POST /v1/images/generationstext, imageimage| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Поле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}
Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Прогноз количества | Плата |
|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Прогноз количества— | Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов |
| КонфигурацияОриентировочная стоимость генерации | Шкала ставок— | Прогноз количестваОценка для одной генерации | Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.385024 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации. |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'microsoft/mai-image-2.5', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nЗагрузите каждое полученное изображение или сохраните его содержимое Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nСохраните каждое готовое изображение; загрузите содержимое по каждому полученному 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