GET
/v1/schemas/fal/video/blackforestlabs/flux-3-max/text-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace178827a9309cb07be52f417626995f08956f7a6e8d3f94de40fa696703796808{
"fetchedAt": 1793941202,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
7 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The text prompt describing the video you want to generate. | length ≥ 1 |
| seed | integer | The seed to use for the generation. Random when not provided. | nullable |
| generate_audio | boolean | Whether to generate audio for the video. | default: true |
| 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" |
| 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" |
| 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" |
| duration | enum | Duration of the generated video in seconds. | 5 | 6 | 7 | 8 | 9 | 10 · +10 more · default: 5 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"blackforestlabs/flux-3-max/text-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}