Семейство MAI Image

Модели генерации и редактирования изображений от Microsoft, всего три. Вызываются через OpenAI-совместимый API, использование в целом такое же, как у GPT Image: генерация по тексту — /v1/images/generations, редактирование — /v1/images/edits.

Выбор модели

Параметры у всех трёх моделей одинаковые; по замерам, генерация изображения 1024×1024 занимает около 12–25 секунд. Актуальные цены см. на странице модели .

Текст в изображение

import base64
from openai import OpenAI
 
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/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))

curl https://api.ofox.ai/v1/images/generations \
  --max-time 600 \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "microsoft/mai-image-2.5-flash",
    "prompt": "Красное яблоко на белом столе",
    "size": "1024x1024"
  }' | jq -r '.data[0].b64_json' | base64 --decode > output.png

Размер (size)

• Вывод сохраняет запрошенное соотношение сторон, а общее число пикселей приводится примерно к 1 миллиону; при слишком маленьком размере вывод будет 768×768.
• Если нужно более высокое разрешение, выберите Nano Banana Pro (до 4K) или GPT Image.

Редактирование

curl https://api.ofox.ai/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 токенов.

Типичные ошибки

Если нужно несколько изображений, отправляйте несколько запросов параллельно — каждый генерирует одно изображение.

Часто задаваемые вопросы