GET
/v1/schemas/fal/image/bria%2Ffibo-2%2Fedit
Accept:
Request body
7 properties · 1 required · 6 $defs| property | type | description | constraints |
|---|---|---|---|
| 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 |
| instruction | string | The 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 |
| vgl | VglEdit | A 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_mode | boolean | If true, returns the image directly in the response (increases latency). | default: false |
| seed | integer | Random seed for reproducibility, 0 to 2147483647. | 0 ≤ n ≤ 2147483647 · default: 5555 |
| aspect_ratio | enum | Output 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_url | string | Mask (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 tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"bria/fibo-2/edit","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}