{"servers":[{"url":"https://api.modellix.ai/api/v1/microsoft/mai-image-2.6"}],"post":{"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":{"content":{"application/json":{"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":{"auto_aspect_ratio":true,"prompt":"A photorealistic product hero shot of a smartwatch on a reflective surface","web_grounding":true}}},"schema":{"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":{"auto_aspect_ratio":{"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.","type":"boolean"},"height":{"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,"maximum":1365,"minimum":768,"type":"integer"},"prompt":{"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","maxLength":32000,"minLength":1,"type":"string"},"web_grounding":{"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.","type":"boolean"},"width":{"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,"maximum":1365,"minimum":768,"type":"integer"}},"required":["prompt"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"code":0,"data":{"get_result":{"method":"GET","url":"https://api.modellix.ai/api/v1/tasks/task-mai-t2i-26-001"},"model_id":"microsoft/mai-image-2.6","status":"pending","task_id":"task-mai-t2i-26-001"},"message":"success"},"schema":{"properties":{"code":{"description":"Response code, 0 indicates success","example":0,"type":"integer"},"data":{"description":"Detailed data about the submitted asynchronous task.","properties":{"get_result":{"description":"API information to query the task result","properties":{"method":{"example":"GET","type":"string"},"url":{"example":"https://api.modellix.ai/api/v1/tasks/task-abc123","type":"string"}},"type":"object"},"model_id":{"description":"Model ID in `provider/model` format","example":"microsoft/mai-image-2.5","type":"string"},"status":{"description":"Task status","enum":["pending","processing"],"example":"pending","type":"string"},"task_id":{"description":"Unique task identifier for polling","example":"task-abc123","type":"string"}},"required":["status","task_id","model_id"],"type":"object"},"message":{"description":"Response message","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Task submitted successfully"},"400":{"content":{"application/json":{"example":{"code":400,"message":"Invalid parameters: width x height exceeds the maximum pixel count 1048576"},"schema":{"properties":{"code":{"example":400,"type":"integer"},"message":{"example":"Invalid parameters: parameter 'prompt' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Invalid request parameters"},"401":{"content":{"application/json":{"example":{"code":401,"message":"Authentication failed: invalid API key"},"schema":{"properties":{"code":{"example":400,"type":"integer"},"message":{"example":"Invalid parameters: parameter 'prompt' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Unauthorized - Invalid or missing API Key"},"429":{"content":{"application/json":{"example":{"code":429,"message":"Rate limit exceeded: 100 requests per minute, retry after 60 seconds"},"schema":{"properties":{"code":{"example":400,"type":"integer"},"message":{"example":"Invalid parameters: parameter 'prompt' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Too many requests - Rate limit exceeded","headers":{"X-RateLimit-Limit":{"description":"Maximum requests per minute","schema":{"example":100,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining quota in current window","schema":{"example":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Rate limit window reset time (Unix timestamp)","schema":{"example":1704067260,"type":"integer"}}}},"500":{"content":{"application/json":{"example":{"code":500,"message":"Internal server error"},"schema":{"properties":{"code":{"example":400,"type":"integer"},"message":{"example":"Invalid parameters: parameter 'prompt' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Internal server error"}},"summary":"MAI Image 2.6","x-mint":{"href":"microsoft/mai-image-2-6"}}}