GET

/v1/schemas/bfl/image/v1/flux-kontext-pro

Accept:

kind inputactivity imagehash 79e65bc9…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

13 properties · 1 required · 1 $defs

property	type	description	constraints
prompt*	string	Text prompt for image generation.
user	string	Opaque identifier for the end user supplied by the calling platform.	length ≥ 1 · length ≤ 256 · nullable
input_image	string	Base64 encoded image or URL to use with Kontext.	nullable
input_image_2	string	Base64 encoded image or URL to use with Kontext. Experimental Multiref	nullable
input_image_3	string	Base64 encoded image or URL to use with Kontext. Experimental Multiref	nullable
input_image_4	string	Base64 encoded image or URL to use with Kontext. Experimental Multiref	nullable
seed	integer	Optional seed for reproducibility.	nullable
aspect_ratio	string	Aspect ratio of the image between 21:9 and 9:21	nullable
output_format	enum	Output format for the generated image. Can be 'jpeg', 'png', or 'webp'.	jpeg \| png \| webp · nullable
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
prompt_upsampling	boolean	Whether to perform upsampling on the prompt. If active, automatically modifies the prompt for more creative generation.	default: false
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

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-kontext-pro","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}