# OpenRouter APIs — Microsoft AI: MAI-Image-2.6 (microsoft/mai-image-2.6)

Guide for calling every confirmed OpenRouter API that serves `microsoft/mai-image-2.6`.

Model page: https://openrouter.ai/microsoft/mai-image-2.6
Create an API key: https://openrouter.ai/settings/keys

## Pricing

Standard-variant prices for `microsoft/mai-image-2.6`, per provider, in the unit each provider bills (tokens, images, seconds of video, or characters of audio). Pay-as-you-go with no markup on the provider's price.

- Azure: $8/M tokens image input, $38/M tokens image output (plus 1 more; see the model page for the full price list)

Full price table, including other variants and per-request charges: https://openrouter.ai/microsoft/mai-image-2.6
How OpenRouter prices requests: https://openrouter.ai/pricing

## EU in-region routing

`microsoft/mai-image-2.6` is not currently available through EU in-region routing.

Docs: https://openrouter.ai/docs/guides/features/in-region-routing

## Authentication

Send this header with every request:

- Authorization: Bearer $OPENROUTER_API_KEY

## Image API

Generate images with `microsoft/mai-image-2.6` through OpenRouter's Image API.

Docs: https://openrouter.ai/docs/guides/overview/multimodal/image-generation
Model discovery API: https://openrouter.ai/api/v1/images/models
Endpoints (microsoft/mai-image-2.6-20260904): https://openrouter.ai/api/v1/images/models/microsoft/mai-image-2.6-20260904/endpoints

### Endpoint

POST https://openrouter.ai/api/v1/images

Headers:
- Content-Type: application/json

### Request fields (microsoft/mai-image-2.6)

- model: string (required) — `"microsoft/mai-image-2.6"`
- prompt: string (required) — text description of the desired image
- aspect_ratio: "1:1" | "4:3" | "3:4" | "16:9" | "9:16" | "3:2" | "2:3" | "auto" (optional) — aspect ratio of the generated image
- n: integer 1-1 (optional) — upper bound on the number of images to generate; providers may return fewer, and single-image providers reject n > 1
- input_references: array of up to 5 image references (optional) — reference images for image-to-image, as `{ "type": "image_url", "image_url": { "url": "…" } }` entries; the url is an https URL or a base64 data URL

These are the generation parameters this model accepts between its providers; an
unlisted value is rejected, and a listed one can still be refused by whichever provider
serves the call. `provider` (routing preferences) is accepted on every request.

### Response

```json
{
  "created": 1748372400,
  "data": [{ "b64_json": "<base64 image bytes>", "media_type": "image/png" }],
  "usage": { "prompt_tokens": 0, "completion_tokens": 4175, "total_tokens": 4175, "cost": 0.04 }
}
```

Base64-decode `data[i].b64_json` and write the bytes to a file; `media_type` gives the extension.
`usage.cost` is the USD charge for the call.

### Examples

#### Flower shop

```bash
curl -X POST https://openrouter.ai/api/v1/images \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "microsoft/mai-image-2.6",
  "prompt": "Transform this storefront into a tasteful neighborhood flower shop on a bright, dry late-spring morning. Replace the shop interior and window display with a restrained, realistic selection of bouquets, potted flowers, and greenery, with a few organized flower buckets near the entrance. Make the sky and street clearly daytime, remove all wet pavement and reflections, use soft natural sunlight and realistic shadows, and turn off the neon glow while keeping the physical sign and the text \"OpenRouter\" perfectly clear and readable. Preserve the exact camera angle, framing, architecture, windows, door, bicycle, and surrounding buildings. Keep the result photorealistic and editorial, not overly decorated.",
  "n": 1,
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://model-assets.openrouter.ai/model-examples/microsoft/mai-image-2.6-20260904/29e6c331-9dac-4219-9d27-eaa2041beff1/input-0.jpg"
      }
    }
  ]
}'
```

### Error differences

- 413 — request body too large

## Text / Chat Completions API

Generate text with `microsoft/mai-image-2.6` through OpenRouter's Chat Completions API.

Docs: https://openrouter.ai/docs/api/api-reference/chat/create-a-chat-completion

### Endpoint

POST https://openrouter.ai/api/v1/chat/completions

Headers:
- Content-Type: application/json

### Request fields (microsoft/mai-image-2.6)

- model: string (required) — `"microsoft/mai-image-2.6"`
- messages: array (required) — ordered conversation messages with `role` and `content`
- stream: boolean (optional) — return Server-Sent Events as tokens are generated
- max_completion_tokens: optional — accepted by this model; see the API reference for its value shape
- max_tokens: optional — accepted by this model; see the API reference for its value shape
- temperature: optional — accepted by this model; see the API reference for its value shape

The model-specific optional fields above come from this model's advertised capabilities.
`stream` and `provider` routing preferences are API controls accepted independently of that
model capability list.

### Response

Without `stream`, the response is a Chat Completions JSON object:

```json
{
  "id": "gen-abc123",
  "choices": [{ "message": { "role": "assistant", "content": "..." } }],
  "usage": { "prompt_tokens": 12, "completion_tokens": 24, "total_tokens": 36, "cost": 0.001 }
}
```

With `stream: true`, the response is `text/event-stream`: read each `data:` JSON chunk until
`data: [DONE]`. The final usage chunk carries token counts and cost when usage is requested.

### Examples

#### Chat completion

```bash
curl -X POST https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "microsoft/mai-image-2.6",
  "messages": [
    {
      "role": "user",
      "content": "What is the meaning of life?"
    }
  ]
}'
```

### Error differences

- 400 — malformed messages or a parameter this model does not support
- 502 — the upstream text generation failed

## Errors

Failures return `{"error": {"code": <number>, "message": <string>}}` with the HTTP status:

- 400 — malformed request or an unsupported parameter
- 401 — missing or invalid API key
- 402 — insufficient credits
- 403 — spend limit reached, key disabled, or access blocked
- 404 — unknown model or no provider can serve the request
- 429 — rate limited; retry with backoff
- 502 — the operation failed upstream; failed generations are not billed

---

Canonical version of this document: https://openrouter.ai/microsoft/mai-image-2.6/llms.txt
