GET

/v1/schemas/fal/video/blackforestlabs/flux-3/image-to-video

kind inputactivity videohash 6acb095e…extracted Oct 16, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.

upstream-spec

Source trace
064e6c898fb8650e77d5126f9439d19744d3389c7633d3c593d8f0a56eb16541
{
  "fetchedAt": 1792126843,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

7 properties · 2 required · 0 $defs
propertytypedescriptionconstraints
prompt*stringThe text prompt describing the video you want to generate.
image_url*stringURL of the image the video starts from (PNG, JPEG, or WebP).
generate_audiobooleanWhether to generate audio for the video.default: true
durationenumDuration of the generated video in seconds. `auto` lets the model choose.auto | 5 | 6 | 7 | 8 | 9 · +11 more · default: "auto"
safety_toleranceintegerThe safety tolerance level for the generated video. 0 is the strictest and 4 is the most permissive.0 ≤ n ≤ 4 · default: 2
aspect_ratioenumAspect 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"
resolutionenumResolution 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"

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"blackforestlabs/flux-3/image-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}