# Microsoft MAI-Image 2.5 Pro - Core.Today AI API

> 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**: Microsoft
- **Model ID**: microsoft/mai-image-2.5-pro
- **Category**: Image Generation
- **Credits**: 400 per image
- **Speed**: Medium
- **Quality**: Ultra

## Features
- High-fidelity output tuned for production and commercial use
- Precise in-image text rendering
- Generate up to 4 images per call
- Multiple aspect ratios, including an auto mode that lets the model choose
- Output as JPEG, PNG, or WebP
- Optional data-URI sync mode for outputs that skip request history

## Use Cases
- Hero imagery and banners for marketing campaigns and landing pages
- Posters or graphics that require precise, legible text rendering
- Photorealistic product or lifestyle concept imagery
- Stylized illustration for commercial design work
- Batch-generating multiple aspect-ratio variants of the same concept

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **prompt**: string - The text prompt to generate an image from.

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

## Examples

### Hero poster with precise banner text
Generate a cinematic marketing poster where a specific headline must render legibly in the image.
```json
{
  "model": "microsoft/mai-image-2.5-pro",
  "input": {
    "prompt": "A photorealistic concept-art poster of a university campus at sunset, cinematic lighting, a banner reading \"LOUISVILLE\" in bold serif type.",
    "aspect_ratio": "auto",
    "output_format": "png",
    "num_images": 1
  }
}
```

### Batch variants for social formats
Generate multiple images at once in a fixed vertical aspect ratio for stories/reels-style placements.
```json
{
  "model": "microsoft/mai-image-2.5-pro",
  "input": {
    "prompt": "A stylized illustration of a coffee cup on a marble counter, warm morning light, minimalist commercial design.",
    "aspect_ratio": "9:16",
    "output_format": "webp",
    "num_images": 4
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- Leave aspect_ratio at auto to let the model choose based on the prompt, or set an explicit ratio when you need consistent output across a batch.
- For in-image text, quote the exact wording in the prompt (e.g. a banner reading "...") to get more accurate rendering.
- Use sync_mode only when you need the image immediately inline and don't need it to persist in request history.
- Raise num_images to generate several compositions from one prompt and pick the best result.

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