Skip to Content
ModelosMAI Image

Familia MAI Image

Los modelos de generación y edición de imágenes de Microsoft, tres en total. Se llaman a través del endpoint compatible con OpenAI y se usan prácticamente igual que GPT Image: texto a imagen con /v1/images/generations y edición con /v1/images/edits.

Elección de modelo

ID de modelo (cópielos tal cual al llamar)
MAI Image 2.5 Promicrosoft/mai-image-2.5-proComposiciones complejas, coherencia de personas y objetos
MAI Image 2.5microsoft/mai-image-2.5Modificaciones locales precisas
MAI Image 2.5 Flashmicrosoft/mai-image-2.5-flashBaja latencia, generación por lotes

Los tres tienen los mismos parámetros; en nuestras mediciones, generar una imagen de 1024×1024 tarda entre 12 y 25 segundos. Para los precios vigentes, consulte la página del modelo .

Texto a imagen

mai_image.py
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="Una manzana roja sobre una mesa blanca", size="1024x1024", ) with open("output.png", "wb") as f: f.write(base64.b64decode(resp.data[0].b64_json))

Tamaño (size)

Clavesize solo determina la relación de aspecto; la salida es de alrededor de 1 millón de píxeles, y enviar un tamaño mayor no aumenta la resolución.
size solicitadoSalida real
Sin enviar1024×1024
1024x1024, 2048x2048, 4096x40961024×1024
1536x10241248×832
1024x1536832×1248
100x100768×768
  • La salida conserva la relación de aspecto solicitada y ajusta el total de píxeles a alrededor de 1 millón; si el tamaño enviado es demasiado pequeño, la salida es de 768×768.
  • Si necesita más resolución, use Nano Banana Pro (hasta 4K) o GPT Image.

Edición

Terminal
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="Cambia la manzana a color morado y deja todo lo demás igual" \ -F image=@apple.jpg \ | jq -r '.data[0].b64_json' | base64 --decode > apple_purple.png

Las imágenes de referencia cuentan como tokens de entrada; consulte usage.input_tokens_details.image_tokens en la respuesta. En nuestras mediciones, una imagen de referencia de 768×768 cuenta como 576 tokens.

Errores habituales

ErrorCausaSolución
Tiempo de espera agotadoEl tiempo de espera del cliente es demasiado cortoConfigúrelo en 300 segundos o más
404 model_not_foundID del modelo mal escritoCopie el ID del modelo de esta página

Si necesita varias imágenes, envíe varias peticiones en paralelo; cada una genera una imagen.

Preguntas frecuentes

¿MAI Image puede generar imágenes en 2K o 4K?

No. size solo determina la relación de aspecto y la salida es de alrededor de 1 millón de píxeles en total. En nuestras mediciones, tanto 2048x2048 como 4096x4096 produjeron 1024x1024. Si necesita más resolución, use Nano Banana Pro o GPT Image.

¿Cómo se edita con MAI Image?

Use /v1/images/edits y suba el archivo image como formulario multipart, igual que con GPT Image.

Última actualización: