GET

/v1/schemas/fal/image/bria%2Ffibo-2%2Fedit

kind inputactivity imagehash 7093e6ce…extracted Oct 23, 2026version currentsource upstream spec ↗

Request body

7 properties · 1 required · 6 $defs
propertytypedescriptionconstraints
image_urls*string[]1-4 images to edit (files or URLs). The instruction refers to them as <image_1>, <image_2> and so on, in the order they are sent.items ≥ 1 · items ≤ 4
instructionstringThe edit, in free-form text. It is expanded into a VGL, which is returned. With 'vgl', the change to make to it. 'prompt' is accepted as an alias.nullable
vglVglEditA VGL (Visual Generation Language) document. Alone, it is the edit as-is and must carry its 'edit_instruction'. With 'instruction', it is the first image's VGL, the baseline the edit is written from. Accepts what a previous request returned.nullable
sync_modebooleanIf true, returns the image directly in the response (increases latency).default: false
seedintegerRandom seed for reproducibility, 0 to 2147483647.0 ≤ n ≤ 2147483647 · default: 5555
aspect_ratioenumOutput aspect ratio, at about one megapixel. Left unset, the output keeps the ratio of the first image. A single image always keeps its own ratio.1:1 | 1:2 | 1:3 | 1:4 | 1:5 | 2:1 · +15 more · nullable
mask_urlstringMask (file or URL) marking the region to regenerate: white where the model should edit, black elsewhere. Single-image requests only, at that image's size. A masked edit comes back at the image's own size, with its own pixels outside the mask.nullable

Validate a payload

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