GET

/v1/schemas/fal/video/blackforestlabs/flux-3/text-to-video/draft

Accept:

kind inputactivity videohash 51cdd9e4…extracted Aug 6, 2026version currentsource upstream spec ↗

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

Request body

5 properties · 1 required · 0 $defs

property	type	description	constraints
prompt*	string	The text prompt describing the draft video.
safety_tolerance	integer	The safety tolerance level for the generated video. 0 is the strictest and 4 is the most permissive.	0 ≤ n ≤ 4 · default: 2
aspect_ratio	enum	Aspect ratio of the generated draft. `auto` lets the model choose.	auto \| 21:9 \| 2:1 \| 16:9 \| 4:3 \| 1:1 · +2 more · default: "auto"
generate_audio	boolean	Whether to generate audio for the draft video.	default: true
duration	enum	Draft duration in whole seconds from 5 through 20, or `auto`.	auto \| 5 \| 6 \| 7 \| 8 \| 9 · +11 more · default: "auto"

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