API docs / Image models

MAI Image 2.5 (Pro text to image) API

Create a high-fidelity hero image with MAI Image 2.5 Pro.

Model id
microsoft/mai-image-2.5-pro
Provider
Microsoft
Output
Image
Price
From 60 credits per run, the same as on voor.ai. Options such as length or resolution can change it.

Request

POST https://voor.ai/v1/generations with "model": "microsoft/mai-image-2.5-pro". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.

curl https://voor.ai/v1/generations \
  -H "Authorization: Bearer $VOOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "microsoft/mai-image-2.5-pro",
  "input": {
    "prompt": "A red fox standing in fresh snow at golden hour, soft light"
  },
  "callback_url": "https://example.com/webhooks/voor"
}'

# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $VOOR_API_KEY"

Input parameters

NameTypeDetails
promptrequiredstring

Up to 5000 characters

aspect_ratiostring

Auto lets the model choose a canvas from the prompt.

Default: auto

One of: auto, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3