GET

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

kind inputactivity videohash ff56cf3c…extracted Aug 6, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.
Source trace
cd8c42daef02994139d6569e05819cac89c4221984769bb0e6f93820bb81022a
{
  "fetchedAt": 1785992534,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

6 properties · 2 required · 0 $defs
propertytypedescriptionconstraints
image_url*stringURL or data URI of the opening keyframe image.
prompt*stringThe text prompt describing the draft video.
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 draft. `auto` lets the model choose.auto | 21:9 | 2:1 | 16:9 | 4:3 | 1:1 · +2 more · default: "auto"
generate_audiobooleanWhether to generate audio for the draft video.default: true
durationenumDraft duration in whole seconds from 5 through 20, or `auto`.auto | 5 | 6 | 7 | 8 | 9 · +11 more · default: "auto"

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/draft","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}