GET
/v1/schemas/fal/video/fal-ai%2Flive-portrait
Accept:
Request body
28 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| video_url* | string | URL of the video to drive the lip syncing. | |
| image_url* | string | URL of the image to be animated | |
| smile | number | Amount to smile | -2 ≤ n ≤ 2 · default: 0 |
| flag_eye_retargeting | boolean | Whether to enable eye retargeting. | default: false |
| pupil_y | number | Amount to move pupils vertically | -45 ≤ n ≤ 45 · default: 0 |
| scale | number | Scaling factor for the face crop. | default: 2.3 |
| flag_lip_retargeting | boolean | Whether to enable lip retargeting. | default: false |
| rotate_roll | number | Amount to rotate the face in roll | -45 ≤ n ≤ 45 · default: 0 |
| blink | number | Amount to blink the eyes | -30 ≤ n ≤ 30 · default: 0 |
| woo | number | Amount to shape mouth in 'woo' position | -100 ≤ n ≤ 100 · default: 0 |
| enable_safety_checker | boolean | Whether to enable the safety checker. If enabled, the model will check if the input image contains a face before processing it. The safety checker will process the input image | default: false |
| flag_do_crop | boolean | Whether to crop the source portrait to the face-cropping space. | default: true |
| aaa | number | Amount to open mouth in 'aaa' shape | -200 ≤ n ≤ 200 · default: 0 |
| flag_relative | boolean | Whether to use relative motion. | default: true |
| vx_ratio | number | Horizontal offset ratio for face crop. | default: 0 |
| rotate_yaw | number | Amount to rotate the face in yaw | -45 ≤ n ≤ 45 · default: 0 |
| pupil_x | number | Amount to move pupils horizontally | -45 ≤ n ≤ 45 · default: 0 |
| rotate_pitch | number | Amount to rotate the face in pitch | -45 ≤ n ≤ 45 · default: 0 |
| eee | number | Amount to shape mouth in 'eee' position | -40 ≤ n ≤ 40 · default: 0 |
| batch_size | integer | Batch size for the model. The larger the batch size, the faster the model will run, but the more memory it will consume. | default: 32 |
| flag_do_rot | boolean | Whether to conduct the rotation when flag_do_crop is True. | default: true |
| flag_stitching | boolean | Whether to enable stitching. Recommended to set to True. | default: true |
| eyebrow | number | Amount to raise or lower eyebrows | -30 ≤ n ≤ 30 · default: 0 |
| flag_lip_zero | boolean | Whether to set the lip to closed state before animation. Only takes effect when flag_eye_retargeting and flag_lip_retargeting are False. | default: true |
| wink | number | Amount to wink | 0 ≤ n ≤ 25 · default: 0 |
| flag_pasteback | boolean | Whether to paste-back/stitch the animated face cropping from the face-cropping space to the original image space. | default: true |
| dsize | integer | Size of the output image. | default: 512 |
| vy_ratio | number | Vertical offset ratio for face crop. Positive values move up, negative values move down. | default: -0.125 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/live-portrait","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}