MicrosoftMediumUltra

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.

400 credits

per image

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

Run it right now

Test this model instantly in the Console Playground — no code required

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "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
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`prompt`	string	Yes	-	The text prompt to generate an image from.
`num_images`	integer	No	1	The number of images to generate.
`aspect_ratio`	string	No	auto	The aspect ratio of the generated image. Use "auto" to let the model decide based on the prompt. auto1:14:33:416:99:163:22:3
`output_format`	string	No	png	The format of the generated image. jpegpngwebp
`sync_mode`	boolean	No	false	If `True`, the media will be returned as a data URI and the output data won't be available in the request history.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Hero poster with precise banner text

Generate a cinematic marketing poster where a specific headline must render legibly in the image.

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "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.

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "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
  }
}'