GET
/v1/schemas/fal/image/fal-ai/image-apps-v2/outpaint
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above.Source trace881a0af4c53766911a858036ccb76d85fc1104dae130f1629e0ac0809bcb75b3{
"fetchedAt": 1783329487,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
12 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| image_url* | string | Image URL to outpaint | |
| expand_right | integer | Number of pixels to add as black margin on the right side (0-700). | 0 ≤ n ≤ 700 · default: 0 |
| seed | integer | The same seed and the same prompt given to the same version of the model will output the same image every time. | nullable |
| expand_top | integer | Number of pixels to add as black margin on the top side (0-700). | 0 ≤ n ≤ 700 · default: 0 |
| enable_safety_checker | boolean | If set to true, the safety checker will be enabled. | default: true |
| expand_left | integer | Number of pixels to add as black margin on the left side (0-700). | 0 ≤ n ≤ 700 · default: 0 |
| output_format | enum | The format of the output image. | png | jpeg | jpg | webp · default: "png" |
| zoom_out_percentage | number | Percentage to zoom out the image. If set, the image will be scaled down by this percentage and black margins will be added to maintain original size. Example: 50 means the image will be 50% of original size with black margins filling the rest. | 0 ≤ n ≤ 90 · default: 20 |
| expand_bottom | integer | Number of pixels to add as black margin on the bottom side (0-700). | 0 ≤ n ≤ 700 · default: 0 |
| sync_mode | boolean | If True, the function will wait for the image to be generated and uploaded before returning the response. If False, the function will return immediately and the image will be generated asynchronously. | default: false |
| num_images | integer | Number of images to generate. | 1 ≤ n ≤ 4 · default: 1 |
| prompt | string | Optional prompt to guide the outpainting. If provided, it will be appended to the base outpaint instruction. Example: 'with a beautiful sunset in the background' | length ≤ 500 · default: "" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/image-apps-v2/outpaint","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}