falImage to videoComing soon

fal-ai/live-portrait

fal-ai/live-portrait is an image to video tool from fal that runs in the background and returns video. Coming soon: listed with its price, not yet open to runs.

This tool is listed but not yet available to run.

Price pending

Pricing

Price pending.

Limits

Runs
In the background
Returns
video
Longest queue wait
3600s
Run deadline
3600s
Largest inline input
1024 KB
Largest input file
500 MB
Largest output
4768 MB
Outputs per run
16

Input

FieldKindDefaultDescription
video_url requiredURL or file—URL of the video to drive the lip syncing.
image_url requiredURL or file—URL of the image to be animated
blinknumber
-30 to 30
0Amount to blink the eyes
eyebrownumber
-30 to 30
0Amount to raise or lower eyebrows
winknumber
0 to 25
0Amount to wink
pupil_xnumber
-45 to 45
0Amount to move pupils horizontally
pupil_ynumber
-45 to 45
0Amount to move pupils vertically
aaanumber
-200 to 200
0Amount to open mouth in 'aaa' shape
eeenumber
-40 to 40
0Amount to shape mouth in 'eee' position
woonumber
-100 to 100
0Amount to shape mouth in 'woo' position
smilenumber
-2 to 2
0Amount to smile
flag_lip_zerotrue or falsetrueWhether to set the lip to closed state before animation. Only takes effect when flag_eye_retargeting and flag_lip_retargeting are False.
rotate_pitchnumber
-45 to 45
0Amount to rotate the face in pitch
rotate_yawnumber
-45 to 45
0Amount to rotate the face in yaw
rotate_rollnumber
-45 to 45
0Amount to rotate the face in roll
flag_eye_retargetingtrue or falsefalseWhether to enable eye retargeting.
flag_lip_retargetingtrue or falsefalseWhether to enable lip retargeting.
flag_stitchingtrue or falsetrueWhether to enable stitching. Recommended to set to True.
flag_relativetrue or falsetrueWhether to use relative motion.
flag_pastebacktrue or falsetrueWhether to paste-back/stitch the animated face cropping from the face-cropping space to the original image space.
flag_do_croptrue or falsetrueWhether to crop the source portrait to the face-cropping space.
flag_do_rottrue or falsetrueWhether to conduct the rotation when flag_do_crop is True.
dsizenumber (whole)512Size of the output image.
scalenumber2.3Scaling factor for the face crop.
vx_rationumber0Horizontal offset ratio for face crop.
vy_rationumber-0.125Vertical offset ratio for face crop. Positive values move up, negative values move down.
batch_sizenumber (whole)32Batch size for the model. The larger the batch size, the faster the model will run, but the more memory it will consume.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/live-portrait",
    "input": {
      "video_url": "https://storage.googleapis.com/falserverless/model_tests/live-portrait/liveportrait-example.mp4",
      "image_url": "https://storage.googleapis.com/falserverless/model_tests/live-portrait/XKEmk3mAzGHUjK3qqH-UL.jpeg"
    }
  }'