GET
/v1/schemas/fal/video/blackforestlabs/flux-3-max/image-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace209e29355009005ea8e46739b4ff202e22604431d618a22ca7a6944b79c06259{
"fetchedAt": 1793941202,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
9 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The text prompt describing how the video unfolds from the image. | length ≥ 1 |
| image_url* | string | URL of the image the video starts from (PNG, JPEG, or WebP). | |
| 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" |
| 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 |
| end_image_url | string | Optional URL of the image used as the last frame of the video (PNG, JPEG, or WebP). | nullable |
| 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 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"blackforestlabs/flux-3-max/image-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}