GET

/v1/schemas/bfl/image/v1/flux-pro-1.0-fill

Accept:

kind inputactivity imagehash e2469156…extracted Oct 22, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `ea458c661ef8b0e03d72ee6b29267451f5a04ae65f35e55ea8a87e53645ef670` { "fetchedAt": 1792645846, "extractorVersion": "1", "verifiedAt": null }

Request body

12 properties · 1 required · 1 $defs

property	type	description	constraints
image*	string	A Base64-encoded string representing the image you wish to modify. Can contain alpha mask if desired.
user	string	Opaque identifier for the end user supplied by the calling platform.	length ≥ 1 · length ≤ 256 · nullable
mask	string	A Base64-encoded string representing a mask for the areas you want to modify in the image. The mask should be the same dimensions as the image and in black and white. Black areas (0%) indicate no modification, while white areas (100%) specify areas for inpainting. Optional if you provide an alpha mask in the original image. Validation: The endpoint verifies that the dimensions of the mask match the original image.	nullable
prompt	string	The description of the changes you want to make. This text guides the inpainting process, allowing you to specify features, styles, or modifications for the masked area.	nullable
steps	integer	Number of steps for the image generation process	15 ≤ n ≤ 50 · nullable
prompt_upsampling	boolean	Whether to perform upsampling on the prompt. If active, automatically modifies the prompt for more creative generation	nullable
seed	integer	Optional seed for reproducibility	nullable
guidance	number	Guidance strength for the image generation process	1.5 ≤ n ≤ 100 · nullable
output_format	enum	Output format for the generated image. Can be 'jpeg', 'png', or 'webp'.	jpeg \| png \| webp · nullable
safety_tolerance	integer	Tolerance level for input and output moderation. Between 0 and 6, 0 being most strict, 6 being least strict.	0 ≤ n ≤ 6 · default: 2
webhook_url	string	URL to receive webhook notifications	length ≥ 1 · length ≤ 2083 · format: uri · nullable
webhook_secret	string	Optional secret for webhook signature verification	nullable

Types

1 $defs

OutputFormatenum

jpeg | png | webp

Validate a payload

before you spend tokens

shell

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