GET
/v1/schemas/fal/image/google/nano-banana-2.1
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace3875c2218294735448d5cda8cea818efeb36c2853378a783b9840290a3d93c8f{
"fetchedAt": 1791349310,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
12 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The text prompt to generate an image from. | length ≥ 3 · length ≤ 50000 |
| seed | integer | The seed for the random number generator. | nullable |
| sync_mode | boolean | If `True`, the media will be returned as a data URI and the output data won't be available in the request history. | default: false |
| safety_tolerance | enum | The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict. | 1 | 2 | 3 | 4 | 5 | 6 · default: "4" |
| num_images | integer | The number of images to generate. | 1 ≤ n ≤ 4 · default: 1 |
| resolution | enum | The resolution of the image to generate. | 1K | 2K | 4K · default: "1K" |
| aspect_ratio | enum | The aspect ratio of the generated image. Supports extreme ratios: 4:1, 1:4, 8:1, 1:8. Use "auto" to let the model decide based on the prompt. | auto | 21:9 | 16:9 | 3:2 | 4:3 | 5:4 · +9 more · nullable |
| thinking_level | enum | How much the model reasons before generating. Higher levels can improve complex compositions and use more thinking tokens. | minimal | medium | high · nullable |
| limit_generations | boolean | Experimental parameter to limit the number of generations from each round of prompting to 1. Set to `True` to to disregard any instructions in the prompt regarding the number of images to generate and ignore any intermediate images generated by the model. This… | default: true |
| system_prompt | string | Optional system instruction that steers the model's persona and output style across the request. Leave blank to omit; when provided, it is sent as the system instruction to Gemini (or as a system message on OpenAI-compatible providers). | length ≤ 50000 · default: "" |
| enable_web_search | boolean | Enable web search for the image generation task. This will allow the model to use the latest information from the web to generate the image. | default: false |
| output_format | enum | The format of the generated image. | jpeg | png | webp · default: "png" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"google/nano-banana-2.1","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}