GET
/v1/schemas/fal/image/bria/fibo-edit-1.5/expand
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace66c6dbcd0f447474796387113e7e1390521790c706ac235d2caf87ef1bc1cf39{
"fetchedAt": 1792040423,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
12 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| image_url* | string | The image to expand (file or URL). | |
| canvas_size | integer[] | The desired size of the final image after the expansion, as [width, height]. Area must be under 25 megapixels. Pairs with 'original_image_location'. | items ≥ 2 · items ≤ 2 · nullable |
| aspect_ratio | enum | The desired aspect ratio of the final image. Used over 'original_image_size' and 'original_image_location' if provided: the original is centred and the canvas grows around it. | 1:1 | 2:3 | 3:2 | 3:4 | 4:3 | 4:5 · +3 more · nullable |
| retain_original_quality | boolean | Keep the original's own pixels at full resolution. Generation happens near one megapixel, so a larger canvas is scaled up afterwards; leave this on and the region the mask protected is not resampled at all. Turn it off for a uniformly soft result, which can hi… | default: true |
| preserve_alpha | boolean | Keep the input's transparency. The model works in RGB, so the alpha channel is not generated -- the original's own is extended outwards by replicating its edges, which is what expanding a cutout means. Turn it off to get a flattened RGB result. | default: true |
| return_model_output | boolean | Also return the model's own frame, before the original was pasted back and the seam blended. Diagnostic only -- it does not change the returned image. Use it to tell a bad generation apart from a bad composite: a boundary already broken in that frame came from… | default: false |
| sync_mode | boolean | If true, returns the image directly in the response (increases latency). | default: false |
| seed | integer | Reuse the seed from a previous response to recreate that result. Omit it for a random one, which is reported in the response either way. | 0 ≤ n ≤ 2147483647 · nullable |
| original_image_location | integer[] | Top-left corner of the original within the canvas, as [x, y]. May sit outside the canvas, in which case the original is cropped. Ignored if 'aspect_ratio' is provided. | items ≥ 2 · items ≤ 2 · nullable |
| original_image_size | integer[] | The desired size of the original inside the canvas, as [width, height]; it is resized to this before being placed. Ignored if 'aspect_ratio' is provided. | items ≥ 2 · items ≤ 2 · nullable |
| negative_prompt | string | Not supported by this model, and refused rather than ignored -- see 'prompt'. Present only so a request written against the SDXL expansion endpoint fails loudly here instead of silently losing the field. | nullable |
| prompt | string | What should appear in the expanded area. Omit it and the model is asked only to extend the image, which is usually what you want for a plain canvas change. | nullable |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"bria/fibo-edit-1.5/expand","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}