Video
Live Portrait
Transfer a driving video’s facial motion to a still portrait.
- Image to video
- Image editing
Sign in to create. Review the credit cost in the studio before running.
Catalog preview for Live Portrait. Review your own result before publishing.
A starting point.
Choose a clear portrait and a driving clip with readable expressions. The separate image mode adjusts a still face without a driving video.
Before you publish.
Watch the eyes, mouth and face boundary for distortion; compare identity with the source portrait.
Review the quote before running. A failed generation releases its reserved credits. Download the results you want to keep; stored media is retained for 30 days.
Settings and model questionsCheck the available settings and guidance when preparing your input.
Inputs and settings
The default mode requires image_url and video_url. Crop controls and flag_pasteback affect how the animated face fits the original frame.
Adjust eye or lip retargeting separately. Change smile, blink or head rotation gradually rather than pushing several expression controls together.
Inputs, all modes and APIModel IDs, current input limits and the API generation workflow.
Supported inputs
These fields come from the current studio form for live-portrait. Other modes may require different inputs.
| Input | Type | Requirement | Options and limits |
|---|---|---|---|
image_url | Text | Required | — |
video_url | Text | Required | — |
aaa | Number | Optional | ≥ -200 · ≤ 200 |
batch_size | Whole number | Optional | — |
blink | Number | Optional | ≥ -30 · ≤ 30 |
dsize | Whole number | Optional | — |
eee | Number | Optional | ≥ -40 · ≤ 40 |
enable_safety_checker | On/off | Optional | — |
eyebrow | Number | Optional | ≥ -30 · ≤ 30 |
flag_do_crop | On/off | Optional | — |
flag_do_rot | On/off | Optional | — |
flag_eye_retargeting | On/off | Optional | — |
flag_lip_retargeting | On/off | Optional | — |
flag_lip_zero | On/off | Optional | — |
flag_pasteback | On/off | Optional | — |
flag_relative | On/off | Optional | — |
flag_stitching | On/off | Optional | — |
pupil_x | Number | Optional | ≥ -45 · ≤ 45 |
pupil_y | Number | Optional | ≥ -45 · ≤ 45 |
rotate_pitch | Number | Optional | ≥ -45 · ≤ 45 |
rotate_roll | Number | Optional | ≥ -45 · ≤ 45 |
rotate_yaw | Number | Optional | ≥ -45 · ≤ 45 |
scale | Number | Optional | — |
smile | Number | Optional | ≥ -2 · ≤ 2 |
vx_ratio | Number | Optional | — |
vy_ratio | Number | Optional | — |
wink | Number | Optional | ≥ 0 · ≤ 25 |
woo | Number | Optional | ≥ -100 · ≤ 100 |
Check the full model schema for all options and cross-field rules. Request a quote for your selected settings before generating.
Other modes and their inputs
Open the operation you need and check its inputs. Settings from one mode do not automatically apply to another.
Image editinglive-portrait/image
Supported inputs
These fields come from the current studio form for live-portrait/image. Other modes may require different inputs.
| Input | Type | Requirement | Options and limits |
|---|---|---|---|
image_url | Text | Required | — |
aaa | Number | Optional | ≥ -200 · ≤ 200 |
blink | Number | Optional | ≥ -30 · ≤ 30 |
dsize | Whole number | Optional | — |
eee | Number | Optional | ≥ -40 · ≤ 40 |
enable_safety_checker | On/off | Optional | — |
eyebrow | Number | Optional | ≥ -30 · ≤ 30 |
flag_do_crop | On/off | Optional | — |
flag_do_rot | On/off | Optional | — |
flag_lip_zero | On/off | Optional | — |
flag_pasteback | On/off | Optional | — |
output_format | Text | Optional | jpeg, png |
pupil_x | Number | Optional | ≥ -45 · ≤ 45 |
pupil_y | Number | Optional | ≥ -45 · ≤ 45 |
rotate_pitch | Number | Optional | ≥ -45 · ≤ 45 |
rotate_roll | Number | Optional | ≥ -45 · ≤ 45 |
rotate_yaw | Number | Optional | ≥ -45 · ≤ 45 |
scale | Number | Optional | — |
smile | Number | Optional | ≥ -2 · ≤ 2 |
vx_ratio | Number | Optional | — |
vy_ratio | Number | Optional | — |
wink | Number | Optional | ≥ 0 · ≤ 25 |
woo | Number | Optional | ≥ -100 · ≤ 100 |
Check the full model schema for all options and cross-field rules. Request a quote for your selected settings before generating.
Use Live Portrait through the API.
Start with this model ID for the endpoint featured on this page:
live-portrait
Input requirements belong to this model ID. Check a different mode’s schema separately when switching modes.
Available modes
- image-to-video ·
live-portrait - image-to-image ·
live-portrait/image
Check the current model schema for supported inputs and options. Other tasks may use different model IDs.
From quote to result.
Request a credit quote for your input and settings before submitting a generation. A sample output or the price of another model is not a quote for your request.
Follow the generation workflow, then poll the job for its status and result. The API and studio use the same balance.