GET
/v1/schemas/fal/video/fal-ai%2Fheygen%2Favatar3%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. Use '9:16' for portrait (vertical) videos, '16:9' for landscape, '1:1' for square, '4:5' for portrait social video, or '5:4' for landscape social video. | 16:9 | 9:16 | 4:5 | 5:4 | 1:1 · 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/avatar3/digital-twin","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}