Семейство MAI Image
Модели генерации и редактирования изображений от Microsoft, всего три. Вызываются через OpenAI-совместимый API, использование в целом такое же, как у GPT Image: генерация по тексту — /v1/images/generations, редактирование — /v1/images/edits.
Выбор модели
microsoft/mai-image-2.5-proСложная композиция, согласованность людей и объектовmicrosoft/mai-image-2.5Точные локальные правкиmicrosoft/mai-image-2.5-flashНизкая задержка, пакетная генерацияПараметры у всех трёх моделей одинаковые; по замерам, генерация изображения 1024×1024 занимает около 12–25 секунд. Актуальные цены см. на странице модели .
Текст в изображение
Python
import base64
from openai import OpenAI
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.io/v1", timeout=600)
resp = client.images.generate(
model="microsoft/mai-image-2.5-flash",
prompt="Красное яблоко на белом столе",
size="1024x1024",
)
with open("output.png", "wb") as f:
f.write(base64.b64decode(resp.data[0].b64_json))Размер (size)
size определяет только соотношение сторон; вывод — около 1 миллиона пикселей, и больший размер не повышает разрешение.- Вывод сохраняет запрошенное соотношение сторон, а общее число пикселей приводится примерно к 1 миллиону; при слишком маленьком размере вывод будет 768×768.
- Если нужно более высокое разрешение, выберите Nano Banana Pro (до 4K) или GPT Image.
Редактирование
curl https://api.ofox.io/v1/images/edits \
--max-time 600 \
-H "Authorization: Bearer $OFOX_API_KEY" \
-F model=microsoft/mai-image-2.5 \
-F prompt="Сделай яблоко фиолетовым, остальное оставь без изменений" \
-F image=@apple.jpg \
| jq -r '.data[0].b64_json' | base64 --decode > apple_purple.pngРеференсные изображения учитываются как входные токены — см. usage.input_tokens_details.image_tokens в ответе. По замерам, одно референсное изображение 768×768 даёт 576 токенов.
Типичные ошибки
Если нужно несколько изображений, отправляйте несколько запросов параллельно — каждый генерирует одно изображение.
Часто задаваемые вопросы
Может ли MAI Image генерировать изображения в 2K или 4K?
Нет. size определяет только соотношение сторон, а общее число пикселей на выходе — около 1 миллиона. По замерам, и 2048x2048, и 4096x4096 дают 1024x1024. Если нужно более высокое разрешение, используйте Nano Banana Pro или GPT Image.
Как редактировать изображения в MAI Image?
Используйте /v1/images/edits: загрузите файл image через multipart-форму, так же как в GPT Image.