{ "aboutHtml": "

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

Для генерации опишите объект, композицию, материалы, свет, точку обзора и визуальный стиль. Дайте точные слова для этикетки, заголовка или вывески и укажите место. Разработчик выделяет улучшенное отображение текста, портреты, 3D-изображения и коммерческие либо фотореалистичные результаты этой версии. Полезное задание определяет несколько ключевых связей: какой объект выходит на первый план, как он расположен в сцене и куда зритель смотрит сначала. Проверяйте мелкие надписи и детали готового изображения.

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

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

Семейство 2.6 добавляет необязательную привязку к веб-источникам и выбор соотношения сторон моделью. Привязка предоставляет актуальный контекст при интерпретации запроса о реальном месте, предмете или меняющейся информации. Это творческий вход, поэтому проверяйте фактические визуальные детали по нужному объекту. Автоматический выбор пропорций учитывает промпт и изображения при определении формы композиции. Задание может обозначать размещение и макет: например, широкий главный товарный визуал со свободным местом с одной стороны или вертикальное изображение вокруг стоящего человека.

Размер результата определяется общей площадью. Карточка конкретной модели и руководство указывают максимум 2 359 296 пикселей, что равно квадрату 1536×1536. Документированный интерфейс требует ширину и высоту не менее 768 пикселей, при этом любая сторона может превышать 1536, если общая площадь остаётся в пределах. Это допускает вытянутую горизонтальную или вертикальную композицию вместо максимума 1536 на каждой стороне. Например, 1024×2048 содержит 2 097 152 пикселя и соответствует этому правилу. Проверьте конечные размеры под макет, где будет использовано изображение.

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

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

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

", "aboutText": "Microsoft AI MAI-Image-2.6 — версия семейства изображений 2.6, ориентированная на точность, для генерации по тексту и управляемого редактирования существующих визуальных материалов. Карточка описывает диффузионную модель с flow matching, 20 миллиардами параметров без учёта эмбеддингов и контекстом 32K токенов. Результат — изображение: товарная композиция, портрет, брендированная иллюстрация или изменённый визуал, где макет и главные объекты сохраняют согласованность при изменении заданного элемента.\n\nДля генерации опишите объект, композицию, материалы, свет, точку обзора и визуальный стиль. Дайте точные слова для этикетки, заголовка или вывески и укажите место. Разработчик выделяет улучшенное отображение текста, портреты, 3D-изображения и коммерческие либо фотореалистичные результаты этой версии. Полезное задание определяет несколько ключевых связей: какой объект выходит на первый план, как он расположен в сцене и куда зритель смотрит сначала. Проверяйте мелкие надписи и детали готового изображения.\n\nДля редактирования предоставьте исходный материал и задайте изменение вместе с сохраняемыми частями. Документированные задачи включают удаление или замену объектов, изменение атрибутов, перерисовку области, адаптацию макета, обновление текста и устранение артефактов вроде смаза движения. Карточка выделяет рассуждение о масштабе, перспективе, свете и пространственном размещении, чтобы правка соответствовала сцене. При подготовке ясно обозначьте объект или область и объясните цель: локальное исправление, другое расположение либо более широкая смена стиля.\n\nРуководство по редактированию принимает до пяти референсов JPEG или PNG. Назначьте каждому отдельную роль: товар, человек, обстановка, макет или стиль. Например, при правке освещения разместите лампу из одного референса на столе из другого, сохранив перспективу стола и согласовав тень лампы со светом комнаты. Отдельная правка может обновить короткую этикетку, сохранив форму и положение товара. Проверяйте связи референсов в результате, не принимая правдоподобный предмет, отличающийся от предоставленного.\n\nСемейство 2.6 добавляет необязательную привязку к веб-источникам и выбор соотношения сторон моделью. Привязка предоставляет актуальный контекст при интерпретации запроса о реальном месте, предмете или меняющейся информации. Это творческий вход, поэтому проверяйте фактические визуальные детали по нужному объекту. Автоматический выбор пропорций учитывает промпт и изображения при определении формы композиции. Задание может обозначать размещение и макет: например, широкий главный товарный визуал со свободным местом с одной стороны или вертикальное изображение вокруг стоящего человека.\n\nРазмер результата определяется общей площадью. Карточка конкретной модели и руководство указывают максимум 2 359 296 пикселей, что равно квадрату 1536×1536. Документированный интерфейс требует ширину и высоту не менее 768 пикселей, при этом любая сторона может превышать 1536, если общая площадь остаётся в пределах. Это допускает вытянутую горизонтальную или вертикальную композицию вместо максимума 1536 на каждой стороне. Например, 1024×2048 содержит 2 097 152 пикселя и соответствует этому правилу. Проверьте конечные размеры под макет, где будет использовано изображение.\n\nРуководство возвращает результаты генерации и редактирования как данные PNG. Сохраняйте готовое изображение вместе с заданием и исходными референсами при подготовке правок. Карточка называет контекст 32K токенов, а руководство сервинга — максимум контекста промпта 32 000 токенов; при длинном задании сохраняйте эти области применения, не принимая их за размеры изображения. Практический производственный материал — декодированная картинка, которую можно проверить и разместить на странице, слайде или в композиции. Записывайте кадрирование и размещение текста, чтобы дальнейшие правки не меняли назначение дизайна случайно.\n\nВнутри семейства MAI-Image-2.6 выделяет точный контроль и последние улучшения визуальных деталей. MAI-Image-2.6-Flash предоставляет те же возможности генерации, редактирования, привязки к источникам и выбора пропорций в версии для быстрой повторяемой работы. Серия 2.5 имеет меньший документированный предел площади и не наследует настройки привязки и автоматических пропорций 2.6. Выбирайте версию по нужному изображению и процессу правок, не предполагая одинаковость всех настроек по общему имени семейства.\n\nСравнивайте правку со всем исходником: важны сохраняемые лица, идентичность предметов, геометрия, тени, надписи и макет. Даже убедительная фотография может содержать неверную маркировку, несогласованное отражение или изменённую деталь вне запрошенной правки. Следующее исправление должно быть конкретным: этикетка, положение объекта или определённый артефакт. Так последовательное редактирование остаётся полезным и сохраняет объект и композицию исходного задания.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "753794cf6180ecff141ce9ea6694415b44772a9d15ae38a2ea6c1f4f9239f648", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ru", "methods": [ { "html": "
•

Microsoft AI: MAI-Image-2.6

Microsoft AI /microsoft/mai-image-2.6

Начало

Microsoft AI MAI-Image-2.6 генерирует и редактирует изображения для точной дизайнерской работы. Сочетает текст с набором до пяти визуальных референсов, поддерживает необязательную привязку к веб-источникам и автоматический выбор размера композиции, выдаёт PNG до 2 359 296 пикселей. Основные задачи — управляемые правки, текст, портреты и коммерческие визуалы.

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

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

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

Для генерации опишите объект, композицию, материалы, свет, точку обзора и визуальный стиль. Дайте точные слова для этикетки, заголовка или вывески и укажите место. Разработчик выделяет улучшенное отображение текста, портреты, 3D-изображения и коммерческие либо фотореалистичные результаты этой версии. Полезное задание определяет несколько ключевых связей: какой объект выходит на первый план, как он расположен в сцене и куда зритель смотрит сначала. Проверяйте мелкие надписи и детали готового изображения.

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

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

Семейство 2.6 добавляет необязательную привязку к веб-источникам и выбор соотношения сторон моделью. Привязка предоставляет актуальный контекст при интерпретации запроса о реальном месте, предмете или меняющейся информации. Это творческий вход, поэтому проверяйте фактические визуальные детали по нужному объекту. Автоматический выбор пропорций учитывает промпт и изображения при определении формы композиции. Задание может обозначать размещение и макет: например, широкий главный товарный визуал со свободным местом с одной стороны или вертикальное изображение вокруг стоящего человека.

Размер результата определяется общей площадью. Карточка конкретной модели и руководство указывают максимум 2 359 296 пикселей, что равно квадрату 1536×1536. Документированный интерфейс требует ширину и высоту не менее 768 пикселей, при этом любая сторона может превышать 1536, если общая площадь остаётся в пределах. Это допускает вытянутую горизонтальную или вертикальную композицию вместо максимума 1536 на каждой стороне. Например, 1024×2048 содержит 2 097 152 пикселя и соответствует этому правилу. Проверьте конечные размеры под макет, где будет использовано изображение.

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

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

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

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

Ailoot Ultra · Картинки POST /v1/images/generations
Входные данные
text, image
Результат
image
ПолеТипТребованиеЗначения и ограниченияПо умолчанию
ПолеmodelТипstringТребованиеОбязательноЗначения и ограничения
microsoft/mai-image-2.6
По умолчанию—
Поле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
Максимум элементов: 5
По умолчанию—
Поле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.311296 оценка до генерации

Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

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

Ailoot Ultra · Картинки

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.6', '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

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

Ailoot Ultra · Картинки

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

Чтение другого содержимого
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.6

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

/v1/images

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

microsoft/mai-image-2.6

", "method_identity": { "effective_request_model_id": "microsoft/mai-image-2.6", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "microsoft/mai-image-2.6", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|microsoft%2Fmai-image-2.6", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Сохраните возвращённый X-Client-Request-ID для сверки. Читайте только фактически возвращённые значения task_id/asset_id или собственную медиатеку; никогда не составляйте URL задачи из ID операции и никогда не отправляйте запрос создания повторно." }, "outputs": { "all_results": "Сохраняйте полный ответ и заголовки, все фактические результаты, исходные возвращённые идентификаторы и все поля использования. Восстанавливайте исходную операцию без повторной отправки запроса создания.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] }, "parameters": [ { "enum": [ "microsoft/mai-image-2.6" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "maximum": 1, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maximum_items": 5, "minimum_items": 0, "name": "input_references", "required": false, "type": "array" }, { "name": "provider", "required": false, "type": "object" } ], "request_schema": { "properties": { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3", "auto" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 5, "minItems": 0, "type": "array" }, "model": { "enum": [ "microsoft/mai-image-2.6" ], "type": "string" }, "n": { "maximum": 1, "minimum": 1, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" }, "provider": { "description": "Exact image provider preferences from the documented image request schema.", "type": "object" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "microsoft/mai-image-2.6", "prompt": "a red panda astronaut floating in space, studio lighting" }, "content_type": "application/json" } }, "input": { "content_type": "application/json", "material_types": [ "text", "image" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "Фактически возвращённый task_id или запись в медиатеке", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the returned X-Client-Request-ID for reconciliation. Read only actual returned task_id/asset_id values or the owned media library; never build a task URL from the operation ID and never resubmit creation." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "output": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Ориентировочная стоимость генерации", "units": [ { "amount": "0.311296", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.311296", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "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.6', '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\"