GET
/v1/schemas/fal/image/fal-ai/smart-resize
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above.Source tracec32d6122e8118dcf8c5b690f2330adc26ad30de1c66c76339fdac9a0be2993b9{
"fetchedAt": 1783329487,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
9 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| target_sizes* | string[] | The list of target dimensions to generate, each written as ``<width>x<height>`` (e.g. ``"1920x1080"``). One output image is produced per target size (multiplied by ``num_images_per_size``). The endpoint internally picks the smallest nano-banana-pro preset that… | items ≥ 1 · items ≤ 10 |
| image_url* | string | The URL of the source image to resize. | |
| output_format | enum | The output image format. | jpeg | png | webp · default: "png" |
| safety_tolerance | enum | The safety tolerance level applied to the inner nano-banana-pro /edit calls. Higher numbers loosen safety filtering. | 1 | 2 | 3 | 4 | 5 | 6 · default: "4" |
| sync_mode | boolean | When True, the response contains data URIs in place of CDN URLs so the client can decode the images without an extra HTTP request. Adds latency for large outputs. | default: false |
| seed | integer | Optional random seed forwarded to the inner nano-banana-pro /edit calls for reproducibility. The same seed is used for every target size when set. | nullable |
| resolution | enum | Hint for the minimum resolution tier to use internally. The smart-resize algorithm may pick a higher tier automatically when the requested target size is too large for this tier. This field does not affect the final output dimensions — those come from ``target… | 1K | 2K | 4K · default: "1K" |
| prompt | string | Optional extra instruction that is forwarded to nano-banana-pro alongside the auto-generated resize prompt. Leave empty to let the model preserve the original image content as closely as possible. | length ≤ 5000 · default: "" |
| num_images_per_size | integer | The number of nano-banana-pro variants to produce for each target size. The response images list will contain ``len(target_sizes) * num_images_per_size`` images in total. | 1 ≤ n ≤ 4 · default: 1 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/smart-resize","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}