GET

/v1/schemas/fal/video/blackforestlabs%2Fflux-3%2Fkeyframes-to-video%2Fdraft

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

Request body

6 properties · 2 required · 1 $defs
propertytypedescriptionconstraints
keyframes*Flux3Keyframe[]Keyframe images pinned to frame positions in the generated draft. Up to 10 keyframes with unique `frame_index` values.items ≥ 1 · items ≤ 10
prompt*stringThe text prompt describing the draft video.
safety_toleranceintegerThe safety tolerance level for the generated video. 0 is the strictest and 4 is the most permissive.0 ≤ n ≤ 4 · default: 2
aspect_ratioenumAspect 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_audiobooleanWhether to generate audio for the draft video.default: true
durationenumDraft duration in whole seconds from 5 through 20. An explicit duration is required to validate keyframe positions.5 | 6 | 7 | 8 | 9 | 10 · +10 more · default: 5

Validate a payload

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