# Microsoft MAI-Image 2.5 Pro

> Microsoft's highest-fidelity image model for production-grade text-to-image generation via Fal.AI. Built for hero imagery, detailed compositions, precise text rendering, photorealism, stylized illustration, commercial design, and visually rich concept work.

- **Provider**: fal
- **Model ID**: microsoft/mai-image-2.5-pro
- **Category**: image_generation
- **Credits**: 400 per request
- **Pricing Type**: fixed

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `sync_mode` (boolean, optional): If `True`, the media will be returned as a data URI and the output data won't be available in the request history. (Default: `False`)
- `aspect_ratio` (string, optional): The aspect ratio of the generated image. Use "auto" to let the model decide based on the prompt. (Default: `auto`; Options: `auto`, `1:1`, `4:3`, `3:4`, `16:9`, `9:16`, `3:2`, `2:3`)
- `output_format` (string, optional): The format of the generated image. (Default: `png`; Options: `jpeg`, `png`, `webp`)
- `prompt` (string, **required**): The text prompt to generate an image from.
- `num_images` (integer, optional): The number of images to generate. (Default: `1`; Range: min: 1, max: 4)

## Example Request

```json
{
  "model": "microsoft/mai-image-2.5-pro",
  "input": {
    "aspect_ratio": "auto",
    "output_format": "png",
    "prompt": "A photorealistic concept-art poster of a university campus at sunset, cinematic lighting, a banner reading \"LOUISVILLE\" in bold serif type.",
    "num_images": 1
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

json

## Tags

image-generation, text-to-image, microsoft

## Documentation

https://fal.ai/models/microsoft/mai-image-2.5-pro