LivePortrait is a video-driven portrait animation system that can animate a portrait video using another driving video. It can also retarget facial expressions from one image to another.

source_file

driving_file

The eye-opening ratio for initialization; set to -1 for automatic calculation.

input_eye_ratio

The lip-opening ratio for initialization; set to -1 for automatic calculation.

input_lip_ratio

Whether to neutralize expressions in the first frame.

neutralize_first_frame

Whether to use relative motion for animation.

flag_relative_motion

Retarget the eyes expression/direction to match driving video

flag_eye_retargeting

Rearget the lips to match the state of the driving video

flag_lip_retargeting

Whether to crop the source image/video to the face-cropping space.

flag_do_crop

Whether to stitch the animated face back to the original image space.

flag_pasteback

Whether to stitch frames for smoother transitions.

flag_stitching

Choose 'expression-friendly' or 'pose-friendly' modes for driving.

driving_option

Multiplier for the driving motion, used in 'expression-friendly' mode.

driving_multiplier

flag_crop_driving_video

Whether to apply head rotation from the driving video to the source.

flag_video_editing_head_rotation

Scale factor for face cropping; a larger scale results in a smaller face area.

scale

Horizontal shift ratio for face cropping; positive values shift right.

vx_ratio

Vertical shift ratio for face cropping; positive values shift up.

vy_ratio

maximum dimension for the height and width of the source video

source_max_dim

Scale factor for cropping the driving video.

scale_crop_driving_video

Horizontal shift ratio for cropping the driving video; positive values shift right.

vx_ratio_crop_driving_video

Vertical shift ratio for cropping the driving video; positive values shift up.

vy_ratio_crop_driving_video

Variance parameter for smoothing the animation; larger values increase smoothness.