GET

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

Accept:

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

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

Request body

7 properties · 1 required · 0 $defs

property	type	description	constraints
prompt*	string	The text prompt describing the video you want to generate	length ≥ 1 · length ≤ 5000
resolution	enum	The resolution of the generated video	720p \| 1080p \| true_1080p · default: "1080p"
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
duration	enum	Duration of the generated video in seconds	4 \| 8 \| 12 \| 16 \| 20 · default: 4
aspect_ratio	enum	The aspect ratio of the generated video	9:16 \| 16:9 · default: "16:9"
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
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

Validate a payload

before you spend tokens

shell

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