GET

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

Accept:

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

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

Request body

6 properties · 2 required · 1 $defs

property	type	description	constraints
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*	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. An explicit duration is required to validate keyframe positions.	5 \| 6 \| 7 \| 8 \| 9 \| 10 · +10 more · default: 5

Types

1 $defs

Flux3Keyframeobject

image_url*	string	URL of the keyframe image (PNG, JPEG, or WebP).
frame_index*	integer	Frame position of this keyframe in the generated 24 fps video. Must be unique and at most `duration * 24`.	n ≥ 0

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", …}]}