curl --request POST \
  --url https://api.modellix.ai/api/v1/microsoft/mai-image-2.5 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A photorealistic concept art poster of a university at sunset, cinematic lighting"
}
'

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

{
  "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

[Core Function] MAI Image 2.5 is Microsoft’s flagship text-to-image generation model. [Strengths] It excels at producing high-quality, detailed images from a text prompt with precise control over output dimensions. [Best For] Highly recommended for: concept art, marketing visuals, and high-fidelity image generation. [Limitations] Do NOT request dimensions below 768 on any side or a width x height product above 1,048,576 pixels (e.g. beyond 1024x1024); output is always PNG. [Routing] Use this model by default for quality-sensitive generation. For faster, cheaper generation, route to MAI Image 2.5 Flash.

POST

microsoft

mai-image-2.5

curl --request POST \
  --url https://api.modellix.ai/api/v1/microsoft/mai-image-2.5 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A photorealistic concept art poster of a university at sunset, cinematic lighting"
}
'

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

{
  "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

Kolors virtual try on v1 5 Mai image 2 5 edit