GET

/v1/schemas/fal/video/fal-ai/veo3/image-to-video

kind inputactivity videohash 341324ad…extracted Jul 6, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.
Source trace
3545c2fb4c00771e354c924ddd370581b766ed4de760d9671271d887c332c403
{
  "fetchedAt": 1783329487,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

10 properties · 2 required · 0 $defs
propertytypedescriptionconstraints
prompt*stringThe text prompt describing how the image should be animatedlength ≤ 20000
image_url*stringURL of the input image to animate. Should be 720p or higher resolution in 16:9 or 9:16 aspect ratio. If the image is not in 16:9 or 9:16 aspect ratio, it will be cropped to fit.
generate_audiobooleanWhether to generate audio for the video.default: true
durationenumThe duration of the generated video.4s | 6s | 8s · default: "8s"
safety_toleranceenumThe safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.1 | 2 | 3 | 4 | 5 | 6 · default: "4"
resolutionenumThe resolution of the generated video.720p | 1080p · default: "720p"
negative_promptstringA negative prompt to guide the video generation.nullable
seedintegerThe seed for the random number generator.nullable
aspect_ratioenumThe aspect ratio of the generated video.auto | 16:9 | 9:16 · default: "auto"
auto_fixbooleanWhether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.default: false

Validate a payload

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