GET
/v1/schemas/fal/image/fal-ai/flux-kontext/dev
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace183ed1fd22428aa21cd99931b0e86e70b97862a8c3b3703fe708626bca0bde0e{
"fetchedAt": 1794546001,
"extractorVersion": "2",
"verifiedAt": null
} |
Request body
11 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| image_url* | string | The URL of the image to edit. | |
| prompt* | string | The prompt to edit the image. | |
| output_format | enum | Output format | jpeg | png · default: "jpeg" |
| guidance_scale | number | The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. | 1 ≤ n ≤ 20 · default: 2.5 |
| acceleration | enum | The speed of the generation. The higher the speed, the faster the generation. | none | regular | high · default: "none" |
| 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 |
| num_inference_steps | integer | The number of inference steps to perform. | 10 ≤ n ≤ 50 · default: 28 |
| 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 |
| num_images | integer | The number of images to generate. | 1 ≤ n ≤ 4 · default: 1 |
| resolution_mode | enum | Determines how the output resolution is set for image editing. - `auto`: The model selects an optimal resolution from a predefined set that best matches the input image's aspect ratio. This is the recommended setting for most use cases as it's what the model w… | auto | match_input | 1:1 | 16:9 | 21:9 | 3:2 · +7 more · default: "match_input" |
| enable_safety_checker | boolean | If set to true, the safety checker will be enabled. Disabling it requires account authorization; unauthorized requests are always checked, and images flagged as unsafe are returned as black images. | default: true |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/flux-kontext/dev","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}