GET
/v1/schemas/fal/video/fal-ai%2Fheygen%2Favatar4%2Fdigital-twin
Accept:
Request body
5 properties · 2 required · 2 $defs| property | type | description | constraints |
|---|---|---|---|
| voice* | TextVoice | Voice configuration for the character | |
| character* | Character | Character configuration for the video | |
| aspect_ratio | enum | Aspect ratio of the output video. Supported values: '16:9', '9:16', '4:5', '5:4', '1:1', and 'auto'. 'auto' preserves the source aspect ratio when HeyGen can read it, falling back to '16:9' otherwise. | 16:9 | 9:16 | 4:5 | 5:4 | 1:1 | auto · default: "16:9" |
| resolution | enum | Video resolution preset. Options: 360p, 480p, 540p, 720p, 1080p | 360p | 480p | 540p | 720p | 1080p · default: "720p" |
| audio_url | string | URL of an audio file for the avatar to lip-sync to. When provided, the avatar uses this audio instead of text-to-speech. | nullable |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/heygen/avatar4/digital-twin","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}