GET

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

kind inputactivity videohash 67ac2027…extracted Oct 16, 2026version currentsource upstream spec ↗

Request body

7 properties · 2 required · 1 $defs
propertytypedescriptionconstraints
prompt*stringThe text prompt describing the video you want to generate.
keyframes*Flux3Keyframe[]Keyframe images pinned to frame positions in the generated video. Up to 10 keyframes with unique `frame_index` values.items ≥ 1 · items ≤ 10
generate_audiobooleanWhether to generate audio for the video.default: true
durationenumDuration of the generated video in seconds. An explicit duration is required to validate keyframe positions.5 | 6 | 7 | 8 | 9 | 10 · +10 more · default: 5
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 video. `auto` lets the model choose.auto | 21:9 | 2:1 | 16:9 | 4:3 | 1:1 · +2 more · default: "auto"
resolutionenumResolution of the generated video. `1080p`, `1440p` (2K) and `2160p` (4K) are finished by the video upsampler; exact dimensions depend on the aspect ratio.720p | 1080p | 1440p | 2160p · default: "720p"

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