models/Microsoft/Mai Image 2.5 Text to Image
Microsoft

Mai Image 2.5 Text to Image

image
Compare

MAI-Image-2.5 is Microsoft's photorealistic image generation and editing model that turns text prompts or uploaded images into high-quality, design-ready visuals with fine-grained, pixel-level control.

MODALITIES
image
PER IMAGE
$1.00
USAGE
129 req
0% market share

Mai Image 2.5 Text to Image (microsoft/mai-image-2.5) is a image model from Microsoft. Pricing via AIgateway: $1.00 per image. Call it via https://api.aigateway.sh/v1/images/generations — set model="microsoft/mai-image-2.5".

model · microsoft/mai-image-2.5

Use this model

model: microsoft/mai-image-2.5
curl https://api.aigateway.sh/v1/images/generations \
  -H "Authorization: Bearer $AIGATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"microsoft/mai-image-2.5","prompt":"a serene cyberpunk city at dusk"}'

Capabilities

Text to image

Adoption

129 requests
0% of tracked market demand
See the full leaderboard →
Aggregate demand across the open model ecosystem (as of 2026-09-11).

Pricing

Per image$1.00
You pay pass-through pricing.
See API example →CompareAPI referenceSee usage ranking →

Collections

More image models →More from MicrosoftFrontier models →Free-tier models →
API schema

Call Mai Image 2.5 Text to Image from any OpenAI SDK

POST https://api.aigateway.sh/v1/images/generations·Content-Type: application/json·Auth: Bearer sk-aig-...

Request body

json
{
  "model": "microsoft/mai-image-2.5",
  "prompt": "A cyberpunk cat at sunset, cinematic lighting",
  "n": 1,
  "size": "1024x1024",
  "response_format": "url"   // or "b64_json"
}

Response

json
{
  "created": 1776947082,
  "data": [
    { "url": "https://media.aigateway.sh/img/abc123.png" }
    // or { "b64_json": "iVBORw0KGgoAAAANSUhEU..." }
  ]
}

Quickstart

from openai import OpenAI
client = OpenAI(base_url="https://api.aigateway.sh/v1", api_key="sk-aig-...")

r = client.images.generate(
    model="microsoft/mai-image-2.5",
    prompt="a cyberpunk cat at sunset",
    size="1024x1024",
)
print(r.data[0].url)

Errors

401authentication_errorInvalid or missing API key
402insufficient_creditsWallet empty (PAYG only)
404not_foundUnknown model or endpoint
429rate_limit_errorOver per-minute limit — see Retry-After header
500server_errorUpstream provider failed (retryable)
503service_unavailableUpstream saturated (retryable)
Full docs →API reference →OpenAPI spec →llms.txt →

Frequently asked questions

What is Mai Image 2.5 Text to Image?
MAI-Image-2.5 is Microsoft's photorealistic image generation and editing model that turns text prompts or uploaded images into high-quality, design-ready visuals with fine-grained, pixel-level control. It is a image model from Microsoft, accessible via AIgateway's OpenAI-compatible API at slug microsoft/mai-image-2.5.
How much does Mai Image 2.5 Text to Image cost via AIgateway?
$1.0000 per image, billed pass-through.
How do I call Mai Image 2.5 Text to Image from my code?
Point the OpenAI SDK at https://api.aigateway.sh/v1 with your AIgateway key and set model to "microsoft/mai-image-2.5". The request and response shapes match OpenAI exactly.
Does Mai Image 2.5 Text to Image support streaming, tool calling, vision, and JSON mode?
Streaming — no. Tool calling — no. Vision — no. JSON mode — no. Prompt caching — no.
Can I bring my own Microsoft API key (BYOK)?
Yes. Attach a Microsoft key in your AIgateway dashboard and this model flips to pass-through — you pay Microsoft directly and AIgateway adds no platform fee on those calls.