GET

/v1/schemas/fal/image/fal-ai/flux-pro/v1/fill

Accept:

kind inputactivity imagehash 3642d4e0…extracted Jul 6, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. Source trace `2739950a9c5e13560368f1cb22021909faf2fa69158db88ba346587bc318f24c` { "fetchedAt": 1783328807, "extractorVersion": "1", "verifiedAt": null }

Request body

9 properties · 3 required · 0 $defs

property	type	description	constraints
mask_url*	string	The mask URL to inpaint the image. Needs to match the dimensions of the input image.
image_url*	string	The image URL to generate an image from. Needs to match the dimensions of the mask.
prompt*	string	The prompt to fill the masked part of the image.
num_images	integer	The number of images to generate.	1 ≤ n ≤ 4 · default: 1
output_format	enum	The format of the generated image.	jpeg \| png · default: "jpeg"
safety_tolerance	enum	The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive.	1 \| 2 \| 3 \| 4 \| 5 \| 6 · default: "2"
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
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
enhance_prompt	boolean	Whether to enhance the prompt for better results.	default: false

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/flux-pro/v1/fill","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}