GET

/v1/schemas/fal/video/fal-ai/sora-2/image-to-video/pro

Accept:

kind inputactivity videohash a98a74b3…extracted Jul 6, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. Source trace `082da0a62f5e715694f59e6f93ac42faa8b6d0183ed48e1a6aa82a60e44ed51a` { "fetchedAt": 1783329487, "extractorVersion": "1", "verifiedAt": null }

Request body

8 properties · 2 required · 0 $defs

property	type	description	constraints
image_url*	string	The URL of the image to use as the first frame
prompt*	string	The text prompt describing the video you want to generate	length ≥ 1 · length ≤ 5000
character_ids	string[]	Up to two character IDs (from create-character) to use in the video. Refer to characters by name in the prompt. When set, only the OpenAI provider is used.	items ≤ 2 · nullable
duration	enum	Duration of the generated video in seconds	4 \| 8 \| 12 \| 16 \| 20 · default: 4
resolution	enum	The resolution of the generated video	auto \| 720p \| 1080p \| true_1080p · default: "auto"
delete_video	boolean	Whether to delete the video after generation for privacy reasons. If True, the video cannot be used for remixing and will be permanently deleted.	default: true
detect_and_block_ip	boolean	If enabled, the prompt (and image for image-to-video) will be checked for known intellectual property references and the request will be blocked if any are detected.	default: false
aspect_ratio	enum	The aspect ratio of the generated video	auto \| 9:16 \| 16:9 · default: "auto"

Validate a payload

before you spend tokens

shell

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