GET

/v1/schemas/fal/video/fal-ai/sora-2/characters

kind inputactivity videohash d4336e85…extracted Jul 6, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.
Source trace
f64e70d2f77f3aa28fb0984c95f6010e864b298240250b1b4d7b0eb700fd4dd8
{
  "fetchedAt": 1783331098,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

2 properties · 2 required · 0 $defs
propertytypedescriptionconstraints
name*stringName for the character (1–80 characters). Refer to this name in prompts when using the character.length ≥ 1 · length ≤ 80
video_url*stringURL of an MP4 video (minimum 720p, max ~2.67:1 aspect ratio) to define the character. Videos exceeding 1080p are automatically scaled down. Non-standard aspect ratios are automatically padded to 16:9 (landscape) or 9:16 (portrait). Videos longer than 4 seconds…length ≥ 1

Validate a payload

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