GET
/v1/schemas/fal/video/blackforestlabs/flux-3-max/keyframes-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace2aa68ae97e6cd1178b614f815ee604c87cbf3555b7ac91f8fac648a79175f703{
"fetchedAt": 1793941202,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
8 properties · 2 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| keyframes* | AlligatorKeyframe[] | Keyframe images pinned to frame positions in the generated video. Up to 10 keyframes with unique `frame_index` values. | items ≥ 1 · items ≤ 10 |
| prompt* | string | The text prompt describing how the video moves between keyframes. | length ≥ 1 |
| resolution | enum | Resolution of the generated video. `1080p`, `2K` (1440p) and `4K` (2160p) are upscaled from the 720p generation; exact dimensions depend on the aspect ratio. | 720p | 1080p | 2K | 4K · default: "720p" |
| aspect_ratio | enum | Aspect ratio of the generated video. `auto` uses 16:9 for text prompts and follows the first image otherwise. | auto | 21:9 | 2:1 | 16:9 | 4:3 | 1:1 · +2 more · default: "auto" |
| generate_audio | boolean | Whether to generate audio for the video. | default: true |
| duration | enum | Duration of the generated video in seconds. | 5 | 6 | 7 | 8 | 9 | 10 · +10 more · default: 5 |
| seed | integer | The seed to use for the generation. Random when not provided. | nullable |
| reasoning_level | enum | How much effort the harness spends reasoning about the given prompt. Higher reasoning effort means slower generation time. | low | high · default: "high" |
Types
1 $defsAlligatorKeyframeobject
| frame_index* | integer | Frame position of this keyframe in the generated 24 fps video. Must be unique and at most `duration * 24`. | n ≥ 0 |
| image_url* | string | URL of the keyframe image (PNG, JPEG, or WebP). |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"blackforestlabs/flux-3-max/keyframes-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}