API Free WeekHundreds of APIs are free to call this week.Browse free APIs

MAI Image 2.5 Edit

microsoft/mai-image-2.5/edit

Mai Image 2.5 Edit by Microsoft - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.

Base price
$0.05USD / run
Execution
async
Model type
image
Input fields
4
Production route

Try the model

Playground

Open playground
Input
The instruction describing how to edit the input image(s).

PNG, JPEG, WebP, or GIF · 20 MiB maximum each

The URL of the image to edit. Provide one http(s) or data: URL.
The format of the generated image. Allowed values: jpeg, png.
The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.
OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price
$0.05 / run

Context & modalities

Input
Schema-defined
Output
image

Capabilities

Chat
Not supported
Vision
Not supported
Reasoning
Not supported
Structured output
Not supported
Function calling
Not supported
Audio input
Not supported

Access

Provider
Microsoft
Model ID
microsoft/mai-image-2.5/edit
Execution
async
Base URL
https://api.sandbase.ai
API
Unified Run API
Endpoint
/v1/run

Human preference

Arena

Elo ratings from blind side-by-side votes, compared with other image and video models.

Rankings sourced from Artificial Analysis Arena

Leaderboard
Image Editing
Rank
#7 of 80
Elo
1112 ±8
Gap to #1
−70

Image-editing arena: people pick the better of two edits of the same image and instruction, without seeing the model names.

  1. #2GPT Image 2.5 Flare (max)OpenAIOn SandBase1162±8
  2. #3MAI-Image-2.6Microsoft AI1137±8
  3. #4MAI-Image-2.6-FlashMicrosoft AI1126±8
  4. #5GPT Image 2 (high)OpenAIOn SandBase1122±8
  5. #6Muse ImageMeta1118±8
  6. #7MAI-Image-2.5Microsoft AIThis model1112±8
  7. #8Nano Banana 2 (Gemini 3.1 Flash Image)GoogleOn SandBase1108±8
  8. #9Grok Imagine Image 2.0SpaceXAIOn SandBase1107±9
  9. #10MAI-Image-2.5-ProMicrosoft AIOn SandBase1107±8
  10. #11Seedream 5.0 ProByteDance SeedOn SandBase1107±8

API README

MAI Image 2.5 Edit

MAI Image 2.5 edit: fast, low-cost edits and multi-image composition from Microsoft.

Fields

FieldTypeDefaultNotes
promptstring, required—Up to 5,000 characters.
imagesimage URL[]—Images to edit or combine, Image 1, Image 2, …
output_formatjpeg / pngpngOutput file format.
aspect_ratio21:9 / 16:9 / 3:2 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 2:3 / 9:16—Output shape.

Billing

$0.05 per output image.

RequestPrice
One image$0.05

Failed runs are not charged.

Prompting

  • State the change and what must stay.

Also on SandBase

Related: microsoft/mai-image-2.5-pro/edit.

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API
Unified Run API endpoint
https://api.sandbase.ai/v1/run
Model ID
microsoft/mai-image-2.5/edit
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "microsoft/mai-image-2.5/edit",
  "images": [
    "https://storage.googleapis.com/falserverless/example_inputs/nano-banana-edit-input.png"
  ],
  "prompt": "Turn this into a clean, futuristic product shot with soft studio lighting.",
  "output_format": "png"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All image & video models
ModelTypeDefault priceReleased
MicrosoftImage$0.05 / runJun 3, 2026
MicrosoftImage$0.29 / runJul 30, 2026

Questions

FAQ

How do I call Microsoft MAI Image 2.5 Edit through SandBase?

Create a SandBase API key, then send requests with the model ID "microsoft/mai-image-2.5/edit" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

Do I need a separate Microsoft account?

No. One SandBase API key and balance gives you access to Microsoft MAI Image 2.5 Edit and the other models in the catalog; you do not need to sign up with Microsoft separately.