> ## 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.7

> Microsoft's text-to-image model for photorealistic product shots, portraits, and layouts that need readable text. It follows detailed prompts about lighting, composition, and typography.

Poll the returned task URL to retrieve the PNG. [Query Task Result](https://docs.modellix.ai/api/get-task-result.md)


## OpenAPI

````yaml /media-model-api/microsoft/microsoft-t2i.json post /microsoft/mai-image-2.7
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.7:
    post:
      summary: MAI Image 2.7
      description: >-
        Microsoft's text-to-image model for photorealistic product shots,
        portraits, and layouts that need readable text. It follows detailed
        prompts about lighting, composition, and typography.
      operationId: maiImage27Async
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MAIImage27Request'
            examples:
              basic:
                summary: Prompt Only
                value:
                  prompt: >-
                    A simple red ceramic mug on a pale blue table, clean studio
                    product photography.
              custom_size:
                summary: Custom Image Size
                value:
                  prompt: >-
                    A simple red ceramic mug on a pale blue table, clean studio
                    product photography.
                  width: 2048
                  height: 1024
      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-image-2-7-001
                  model_id: microsoft/mai-image-2.7
                  get_result:
                    method: GET
                    url: >-
                      https://api.modellix.ai/api/v1/tasks/task-mai-image-2-7-001
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    MAIImage27Request:
      type: object
      required:
        - prompt
      description: >-
        Generate one PNG from a prompt. Set width and height together to
        customize the default 1024 × 1024 size. The total pixel count must be at
        most 4,194,304.
      dependentRequired:
        width:
          - height
        height:
          - width
      properties:
        prompt:
          type: string
          minLength: 1
          maxLength: 32000
          description: >-
            Describe the image to generate. The platform limit is 32,000 UTF-8
            bytes.
          example: >-
            A simple red ceramic mug on a pale blue table, clean studio product
            photography.
        width:
          type: integer
          minimum: 768
          maximum: 5461
          default: 1024
          description: Output dimension in pixels. Provide height when you set this field.
          example: 1024
        height:
          type: integer
          minimum: 768
          maximum: 5461
          default: 1024
          description: Output dimension in pixels. Provide width when you set this field.
          example: 1024
    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`.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.