curl --request POST \
  --url https://api.modellix.ai/api/v1/microsoft/mai-image-2.5-flash \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A flat-design illustration of a city skyline at dawn"
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-mai-t2i-002",
    "model_id": "microsoft/mai-image-2.5-flash",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-mai-t2i-002"
    }
  }
}

{
  "code": 400,
  "message": "Invalid parameters: width x height exceeds the maximum pixel count 1048576"
}

{
  "code": 401,
  "message": "Authentication failed: invalid API key"
}

{
  "code": 429,
  "message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}

{
  "code": 500,
  "message": "Internal server error"
}

MAI Image 2.5 Flash

[Core Function] MAI Image 2.5 Flash is Microsoft’s fast, cost-efficient text-to-image generation model. [Strengths] It excels at quickly generating solid images from a text prompt with the same dimension controls as MAI Image 2.5. [Best For] Highly recommended for: rapid prototyping, batch generation, and cost-sensitive workloads. [Limitations] Do NOT request dimensions below 768 on any side or a width x height product above 1,048,576 pixels; output is always PNG, and maximum fidelity is lower than MAI Image 2.5. [Routing] Choose this model when speed or cost matters more than maximum fidelity. For the highest quality, use MAI Image 2.5.

POST

microsoft

mai-image-2.5-flash

curl --request POST \
  --url https://api.modellix.ai/api/v1/microsoft/mai-image-2.5-flash \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A flat-design illustration of a city skyline at dawn"
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-mai-t2i-002",
    "model_id": "microsoft/mai-image-2.5-flash",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-mai-t2i-002"
    }
  }
}

{
  "code": 400,
  "message": "Invalid parameters: width x height exceeds the maximum pixel count 1048576"
}

{
  "code": 401,
  "message": "Authentication failed: invalid API key"
}

{
  "code": 429,
  "message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}

{
  "code": 500,
  "message": "Internal server error"
}

Authorizations

Authorization

string

header

required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

Microsoft MAI Image text-to-image request. Shared by MAI Image 2.5 and 2.5 Flash. Width and height must be provided together; their product must not exceed 1,048,576 pixels. Output is always PNG.

prompt

string

required

Text description of the image to generate

Required string length: 1 - 32000

Example:

"A photorealistic concept art poster of a university at sunset, cinematic lighting"

width

integer

default:1024

Image width in pixels (>=768). Must be provided together with height; width x height must not exceed 1,048,576.

Required range: 768 <= x <= 1365

Example:

1024

height

integer

default:1024

Image height in pixels (>=768). Must be provided together with width; width x height must not exceed 1,048,576.

Required range: 768 <= x <= 1365

Example:

1024

Response

Task submitted successfully

code

integer

required

Response code, 0 indicates success

Example:

0

message

string

required

Response message

Example:

"success"

data

object

required

Detailed data about the submitted asynchronous task.

Show child attributes

Mai image 2 5 edit Mai image 2 5 flash edit