GET

/v1/schemas/fal/image/microsoft/mai-image-2.5/edit

kind inputactivity imagehash cf9aa177…extracted Jul 6, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.
Source trace
37e6b72922ad1af4a3ea7dfa4167aa1e810c0084c54ab7c94783c411aca5214d
{
  "fetchedAt": 1783329487,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

6 properties · 2 required · 0 $defs
propertytypedescriptionconstraints
image_urls*string[]The URL of the image to edit. Provide one http(s) or data: URL.items ≥ 1 · items ≤ 1
prompt*stringThe instruction describing how to edit the input image(s).length ≥ 3 · length ≤ 5000
sync_modebooleanIf `True`, the media will be returned as a data URI and the output data won't be available in the request history.default: false
output_formatenumThe format of the generated image.jpeg | png | webp · default: "png"
aspect_ratioenumThe aspect ratio of the generated image. Use "auto" to match the input or let the model decide.auto | 1:1 | 4:3 | 3:4 | 16:9 | 9:16 · +2 more · default: "auto"
num_imagesintegerThe number of images to generate.1 ≤ n ≤ 4 · default: 1

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"microsoft/mai-image-2.5/edit","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}