GET

/v1/schemas/fal/image/blackforestlabs/flux-3/text-to-image

kind inputactivity imagehash dc88bdb2…extracted Oct 23, 2026version currentsource upstream spec ↗

Request body

8 properties · 1 required · 0 $defs
propertytypedescriptionconstraints
prompt*stringThe prompt to generate an image from.
versionconstThe model version."latest" · default: "latest"
safety_toleranceintegerSafety tolerance, from 0 (strictest) to 4.0 ≤ n ≤ 4 · default: 2
resolutionenumOutput resolution tier. 4k can take several minutes.768sq | 1k | 1.5k | 2k | 4k · default: "1k"
sync_modebooleanReturn the image as a data URI instead of storing it in request history.default: false
aspect_ratioenumOutput aspect ratio. Auto uses the first reference image when editing.auto | 21:9 | 2:1 | 16:9 | 3:2 | 7:5 · +9 more · default: "auto"
enable_prompt_expansionbooleanExpand the prompt while preserving its intent and reference roles.default: false
output_formatenumThe format of the generated image.jpeg | png · default: "jpeg"

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"blackforestlabs/flux-3/text-to-image","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}