GET
/v1/schemas/fal/video/blackforestlabs/flux-3/keyframes-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace4fcf829aabbeb40aa58cc44d853db8c1c09dd8ee856091adc42af3ca2b3c7183{
"fetchedAt": 1792126843,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
7 properties · 2 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The 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_audio | boolean | Whether to generate audio for the video. | default: true |
| duration | enum | Duration 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_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 video. `auto` lets the model choose. | auto | 21:9 | 2:1 | 16:9 | 4:3 | 1:1 · +2 more · default: "auto" |
| resolution | enum | Resolution 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" |
Types
1 $defsFlux3Keyframeobject
| 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 tokensshell
$ 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", …}]}