GET

/v1/schemas/fal/video/fal-ai/heygen/v2/video-agent

Accept:

kind inputactivity videohash 6c069f05…extracted Oct 9, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `f0bb7b41bfb9c625cdabaa262ed4610066ffeedb89b9dcec61b6a12bd49e1daa` { "fetchedAt": 1791522002, "extractorVersion": "1", "verifiedAt": null }

Request body

3 properties · 1 required · 1 $defs

property	type	description	constraints
prompt*	string	Natural language prompt describing the video to generate. Include details about style, visual elements, and desired length for best results.
config	VideoAgentConfig	Video configuration options
enable_safety_checker	boolean	Authorized callers may set false to request relaxed screening.	default: true

Types

1 $defs

VideoAgentConfigobject

orientation	enum	Video orientation	portrait \| landscape · default: "portrait"
avatar	enum	Optional avatar name to use	Abigail (Upper Body) \| Abigail Office Front \| Abigail Office Side \| Abigail Sofa Front \| Abigail Sofa Side \| Aditya in Brown blazer · +1280 more · default: "Adriana SuitSofa Front"
duration	integer	Approximate duration in seconds (minimum 5). Suggested presets: 30, 60, or 90 seconds.	n ≥ 5 · nullable

Validate a payload

before you spend tokens

shell

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