GET

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

kind inputactivity imagehash 20c1af4f…extracted Aug 1, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.
Source trace
2f258eb17ff603dad3af8648e206bf84b67f6bf51f783551ab12bff01f2a661c
{
  "fetchedAt": 1785560543,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

6 properties · 1 required · 0 $defs
propertytypedescriptionconstraints
prompt*stringThe instruction describing how to edit the input image(s).length ≥ 3 · length ≤ 5000
image_urlstringThe URL of the image to edit. Provide one http(s) or data: URL.default: ""
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"
output_formatenumThe format of the generated image.jpeg | png | webp · default: "png"
num_imagesintegerThe number of images to generate.1 ≤ n ≤ 4 · default: 1
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

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-pro/edit","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}