Skip to main content
Back to API Platform

MAI Image API

Microsoft MAI Image 2.5 — text-to-image with strong prompt adherence, natural lighting, and clean detail across 11 aspect ratios. Integrate this model via REST with endpoint docs, parameters, and code examples.

Prompting guideCompare image modelsUse cases
Image Generation
Credit Cost
1.5 credits
Type
Image

Get API Key

Create auth keys for apps and agents

See Usage

Track requests, credits, and logs

Buy Credits

Top up prepaid API capacity

API Endpoint

POST
/api/v1/models/mai-image/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

LLM.txt

AI-Ready

For AI assistants

Copy this model's documentation into Claude, GPT, or any AI for instant integration help.

/llm/mai-image.txt

OpenAPI Spec

Swagger compatible

Import into Postman, Swagger UI, or generate client SDKs in any language.

/api/openapi

Parameters

Input parameters accepted by this model

ParameterTypeDefault
prompt
required
string
-
aspect_ratio
enum
auto
num_images
integer
1
output_format
enum
png

Supported Aspect Ratios

1:1
16:9
9:16
4:3
3:4
3:2
2:3
5:4
4:5
21:9

Example Outputs

Real outputs generated by this model

A cozy mountain cabin kitchen at morning, copper pots, fresh bread on a wooden table, rustic warm light
View Details

A cozy mountain cabin kitchen at morning, copper pots, fresh bread on a wooden table, rustic warm light

1.5 credits
74.0s
A tranquil zen rock garden with raked sand and a single maple tree, soft overcast light, minimalist composition
View Details

A tranquil zen rock garden with raked sand and a single maple tree, soft overcast light, minimalist composition

1.5 credits
58.7s
A misty mountain valley at dawn, layered ridgelines, a winding river through pine forest, soft light
View Details

A misty mountain valley at dawn, layered ridgelines, a winding river through pine forest, soft light

1.5 credits
104.7s
A cozy independent bookshop interior with warm lamplight and towering shelves, inviting reading nook
View Details

A cozy independent bookshop interior with warm lamplight and towering shelves, inviting reading nook

1.5 credits
85.2s
A delicate hummingbird hovering beside a trumpet flower, iridescent feathers, crisp macro photography
View Details

A delicate hummingbird hovering beside a trumpet flower, iridescent feathers, crisp macro photography

1.5 credits
101.8s
A playful golden retriever leaping into a lake to fetch a stick, water splashing, sunny summer day
View Details

A playful golden retriever leaping into a lake to fetch a stick, water splashing, sunny summer day

1.5 credits
104.1s
A dramatic desert landscape with towering red rock arches under a star-filled night sky, long exposure
View Details

A dramatic desert landscape with towering red rock arches under a star-filled night sky, long exposure

1.5 credits
90.4s
A charming Parisian cafe corner with a striped awning and flowers, cobblestone street, soft morning light
View Details

A charming Parisian cafe corner with a striped awning and flowers, cobblestone street, soft morning light

1.5 credits
89.2s
A vibrant coral reef alive with tropical fish and a sea turtle, crystal-clear water, sun rays underwater
View Details

A vibrant coral reef alive with tropical fish and a sea turtle, crystal-clear water, sun rays underwater

1.5 credits
85.9s
A vintage typewriter on a desk beside a steaming coffee and an open notebook, warm cinematic lighting
View Details

A vintage typewriter on a desk beside a steaming coffee and an open notebook, warm cinematic lighting

1.5 credits
104.5s
A surreal floating island with waterfalls spilling into the clouds, fantasy landscape, golden light
View Details

A surreal floating island with waterfalls spilling into the clouds, fantasy landscape, golden light

1.5 credits
77.1s
A snow-dusted log cabin glowing warmly in a pine forest at twilight, smoke from the chimney, peaceful
View Details

A snow-dusted log cabin glowing warmly in a pine forest at twilight, smoke from the chimney, peaceful

1.5 credits
80.5s
A detailed steaming bowl of ramen with fresh herbs and a soft egg, overhead shot, appetizing food photography
View Details

A detailed steaming bowl of ramen with fresh herbs and a soft egg, overhead shot, appetizing food photography

1.5 credits
46.4s
A field of vibrant tulips stretching to a windmill on the horizon, bright blue sky, Dutch countryside
View Details

A field of vibrant tulips stretching to a windmill on the horizon, bright blue sky, Dutch countryside

1.5 credits
46.1s
A retro 1960s diner at dusk, neon signs glowing, classic cars parked outside, nostalgic warm tones
View Details

A retro 1960s diner at dusk, neon signs glowing, classic cars parked outside, nostalgic warm tones

1.5 credits
108.0s
A curious orange tabby kitten peeking out of a wicker basket, soft window light, adorable detail
View Details

A curious orange tabby kitten peeking out of a wicker basket, soft window light, adorable detail

1.5 credits
92.5s
A powerful waterfall cascading through a lush green canyon, mist catching rainbow light, wide landscape
View Details

A powerful waterfall cascading through a lush green canyon, mist catching rainbow light, wide landscape

1.5 credits
83.7s
An elegant modern living room with floor-to-ceiling windows overlooking a misty forest, warm natural light
View Details

An elegant modern living room with floor-to-ceiling windows overlooking a misty forest, warm natural light

1.5 credits
89.1s
A vibrant street food market at night, glowing lanterns and sizzling woks, rich atmospheric color
View Details

A vibrant street food market at night, glowing lanterns and sizzling woks, rich atmospheric color

1.5 credits
169.5s
A close-up of a bee collecting pollen from a sunflower, wings mid-flutter, macro detail, soft bokeh
View Details

A close-up of a bee collecting pollen from a sunflower, wings mid-flutter, macro detail, soft bokeh

1.5 credits
92.6s
A lone red sailboat on a calm turquoise sea at golden hour, minimalist composition, gentle reflections
View Details

A lone red sailboat on a calm turquoise sea at golden hour, minimalist composition, gentle reflections

1.5 credits
96.0s
A serene Japanese tea garden in spring, cherry blossoms drifting over a koi pond, soft morning light, highly detailed
View Details

A serene Japanese tea garden in spring, cherry blossoms drifting over a koi pond, soft morning light, highly detailed

1.5 credits
105.9s
A majestic snow leopard resting on a rocky Himalayan ledge, piercing eyes, crisp wildlife photography
View Details

A majestic snow leopard resting on a rocky Himalayan ledge, piercing eyes, crisp wildlife photography

1.5 credits
89.5s
A cozy attic art studio bathed in afternoon sun, canvases and brushes everywhere, warm dust motes in the light
View Details

A cozy attic art studio bathed in afternoon sun, canvases and brushes everywhere, warm dust motes in the light

1.5 credits
74.2s

Code Examples

Text → image — copy and paste to get started

bash
curl -X POST "https://pixeldojo.ai/api/v1/models/mai-image/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A vast mirror-like salt flat at golden hour, cinematic",
    "aspect_ratio": "3:2",
    "num_images": 1
  }'

Response Format

Submit Response (202 Accepted)

json
{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 1.5,
  "creditsRemaining": 95,
  "expiresAt": "2026-07-18T05:14:33Z"
}

Completed Response

json
{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "images": [
      "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.png"
    ]
  },
  "creditCost": 1.5,
  "expiresAt": "2026-07-18T05:14:33Z"
}
LLM DocumentationTry in Web UIGet API KeyUsage DashboardBuy Credits