> ## Documentation Index > Fetch the complete documentation index at: https://docs.modellix.ai/llms.txt > Use this file to discover all available pages before exploring further. # MAI Image 2.6 > [Core Function] MAI Image 2.6 is Microsoft's latest text-to-image generation model in the MAI Image family. [Strengths] It improves text rendering, portraits, 3D imagery, and commercial photorealistic output compared with MAI Image 2.5. [Best For] Highly recommended for: marketing visuals, product hero shots, portraits, and prompts that need accurate on-image text. [Limitations] Do NOT use this if the requested width or height is below 768, or if width x height exceeds 1,048,576 pixels. Output is always PNG. auto_aspect_ratio and web_grounding are optional booleans; omit them unless the caller sets them. [Routing] Use this model when the latest MAI quality is required. For lower latency or cost, route to MAI Image 2.6 Flash. ## OpenAPI ````yaml /media-model-api/microsoft/microsoft-t2i.json post /microsoft/mai-image-2.6 openapi: 3.1.0 info: description: >- The text-to-image models API from Microsoft Foundry (MAI Image). Generates images from a text prompt and returns the result (PNG) synchronously via the async task interface. version: 1.0.0 contact: name: Modellix Support email: support@modellix.ai title: Microsoft MAI Image Text-to-Image Models API servers: - url: https://api.modellix.ai/api/v1 description: The text-to-image models API from Microsoft Foundry (MAI Image). security: - bearerAuth: [] paths: /microsoft/mai-image-2.6: post: summary: MAI Image 2.6 description: >- [Core Function] MAI Image 2.6 is Microsoft's latest text-to-image generation model in the MAI Image family. [Strengths] It improves text rendering, portraits, 3D imagery, and commercial photorealistic output compared with MAI Image 2.5. [Best For] Highly recommended for: marketing visuals, product hero shots, portraits, and prompts that need accurate on-image text. [Limitations] Do NOT use this if the requested width or height is below 768, or if width x height exceeds 1,048,576 pixels. Output is always PNG. auto_aspect_ratio and web_grounding are optional booleans; omit them unless the caller sets them. [Routing] Use this model when the latest MAI quality is required. For lower latency or cost, route to MAI Image 2.6 Flash. operationId: maiImage26Async requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/MAIImage26Request' examples: basic: summary: Prompt only (defaults to 1024x1024) value: prompt: >- A photorealistic product hero shot of a smartwatch on a reflective surface with_optional_flags: summary: Optional auto aspect ratio and web grounding value: prompt: >- A photorealistic product hero shot of a smartwatch on a reflective surface auto_aspect_ratio: true web_grounding: true responses: '200': description: Task submitted successfully content: application/json: schema: $ref: '#/components/schemas/AsyncTaskResponse' example: code: 0 message: success data: status: pending task_id: task-mai-t2i-26-001 model_id: microsoft/mai-image-2.6 get_result: method: GET url: https://api.modellix.ai/api/v1/tasks/task-mai-t2i-26-001 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: MAIImage26Request: type: object required: - prompt description: >- Microsoft MAI Image 2.6 text-to-image request. Shared by MAI Image 2.6 and 2.6 Flash. Width and height must be provided together; their product must not exceed 1,048,576 pixels. Output is always PNG. auto_aspect_ratio and web_grounding are optional; omit them to leave upstream defaults (do not send the fields). properties: prompt: type: string minLength: 1 maxLength: 32000 description: >- Text description of the image to generate. Platform limit is 32,000 UTF-8 bytes, not Unicode characters. example: >- A photorealistic concept art poster of a university at sunset, cinematic lighting width: type: integer minimum: 768 maximum: 1365 default: 1024 description: >- Image width in pixels (>=768). Must be provided together with `height`; width x height must not exceed 1,048,576. example: 1024 height: type: integer minimum: 768 maximum: 1365 default: 1024 description: >- Image height in pixels (>=768). Must be provided together with `width`; width x height must not exceed 1,048,576. example: 1024 auto_aspect_ratio: type: boolean description: >- Optional. When true, the model chooses the output aspect ratio from the prompt (and any image inputs). Omit this field to leave the requested width and height unchanged. Do not send it unless the caller explicitly wants model-directed framing. web_grounding: type: boolean description: >- Optional. When true, the model may retrieve current public information (Bing) as extra context for real-world entities, places, or events. Omit this field to generate from the prompt only. Do not send it unless the caller explicitly wants web-grounded generation. AsyncTaskResponse: type: object required: - code - message - data properties: code: type: integer description: Response code, 0 indicates success example: 0 message: type: string description: Response message example: success data: type: object required: - status - task_id - model_id properties: status: type: string enum: - pending - processing description: Task status example: pending task_id: type: string description: Unique task identifier for polling example: task-abc123 model_id: type: string description: Model ID in `provider/model` format example: microsoft/mai-image-2.5 get_result: type: object description: API information to query the task result properties: method: type: string example: GET url: type: string example: https://api.modellix.ai/api/v1/tasks/task-abc123 description: Detailed data about the submitted asynchronous task. ErrorResponse: type: object required: - code - message properties: code: type: integer example: 400 message: type: string example: 'Invalid parameters: parameter ''prompt'' is required' responses: BadRequest: description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 400 message: >- Invalid parameters: width x height exceeds the maximum pixel count 1048576 Unauthorized: description: Unauthorized - Invalid or missing API Key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 401 message: 'Authentication failed: invalid API key' TooManyRequests: description: Too many requests - Rate limit exceeded headers: X-RateLimit-Limit: description: Maximum requests per minute schema: type: integer example: 100 X-RateLimit-Remaining: description: Remaining quota in current window schema: type: integer example: 0 X-RateLimit-Reset: description: Rate limit window reset time (Unix timestamp) schema: type: integer example: 1704067260 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 429 message: >- Rate limit exceeded: 100 requests per minute, retry after 60 seconds InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 500 message: Internal server error securitySchemes: bearerAuth: type: http scheme: bearer description: 'API Key authentication. Format: `Bearer YOUR_API_KEY`.' ````