Live Portrait video to video
Experience the magic of Live Portrait’s Video-to-Video Model! Transform your static images into dynamic videos seamlessly.
1import requests
2import json
3
4url = "https://api.segmind.com/v1/live-portrait-video-to-video"
5headers = {
6 "x-api-key": "YOUR_API_KEY",
7 "Content-Type": "application/json"
8}
9
10data = {
11 "input_video": "https://segmind-sd-models.s3.amazonaws.com/display_images/live-portrait-v2v/live_portrait_v2v_input_vid.mp4",
12 "driving_video": "https://segmind-sd-models.s3.amazonaws.com/display_images/live-portrait-v2v/livie_portrait_driving_vid.mp4",
13 "dsize": 512,
14 "scale": 2.3,
15 "driving_audio": false,
16 "vx_ratio": 0,
17 "vy_ratio": -0.125,
18 "input_face_index": 0,
19 "drive_face_index": 0,
20 "crop_drive_face": false,
21 "lip_zero": true,
22 "lip_zero_threshold": 0.03,
23 "eye_retargeting": false,
24 "eyes_retargeting_multiplier": 1,
25 "lip_retargeting": false,
26 "lip_retargeting_multiplier": 1,
27 "stitching": true,
28 "relative": true,
29 "mismatch_method": "cut",
30 "video_frame_load_cap": 120,
31 "base64": false
32}
33
34response = requests.post(url, headers=headers, json=data)
35
36if response.status_code == 200:
37 result = response.json()
38 print(json.dumps(result, indent=2))
39else:
40 print(f"Error: {response.status_code}")
41 print(response.text)
1import requests
2import json
3
4url = "https://api.segmind.com/v1/live-portrait-video-to-video"
5headers = {
6 "x-api-key": "YOUR_API_KEY",
7 "Content-Type": "application/json"
8}
9
10data = {
11 "input_video": "https://segmind-sd-models.s3.amazonaws.com/display_images/live-portrait-v2v/live_portrait_v2v_input_vid.mp4",
12 "driving_video": "https://segmind-sd-models.s3.amazonaws.com/display_images/live-portrait-v2v/livie_portrait_driving_vid.mp4",
13 "dsize": 512,
14 "scale": 2.3,
15 "driving_audio": false,
16 "vx_ratio": 0,
17 "vy_ratio": -0.125,
18 "input_face_index": 0,
19 "drive_face_index": 0,
20 "crop_drive_face": false,
21 "lip_zero": true,
22 "lip_zero_threshold": 0.03,
23 "eye_retargeting": false,
24 "eyes_retargeting_multiplier": 1,
25 "lip_retargeting": false,
26 "lip_retargeting_multiplier": 1,
27 "stitching": true,
28 "relative": true,
29 "mismatch_method": "cut",
30 "video_frame_load_cap": 120,
31 "base64": false
32}
33
34response = requests.post(url, headers=headers, json=data)
35
36if response.status_code == 200:
37 result = response.json()
38 print(json.dumps(result, indent=2))
39else:
40 print(f"Error: {response.status_code}")
41 print(response.text)
API Endpoint
https://api.segmind.com/v1/live-portrait-video-to-video
Parameters
drive_face_index
requiredinteger
Index of the driving face
0
Range: 0 - 5driving_video
requiredstring (uri)
Driving video
"https://segmind-sd-models.s3.amazonaws.com/display_images/live-portrait-v2v/livie_portrait_driving_vid.mp4"
dsize
requiredinteger
Size of the video
512
Range: 64 - 2048input_face_index
requiredinteger
Index of the input face
0
Range: 0 - 5input_video
requiredstring (uri)
Input video
"https://segmind-sd-models.s3.amazonaws.com/display_images/live-portrait-v2v/live_portrait_v2v_input_vid.mp4"
mismatch_method
requiredstring
Method for mismatch handling
"cut"
"cut"
"circle"
"none"
scale
requirednumber
Scale of the video
2.3
Range: 1 - 4video_frame_load_cap
requiredinteger
The maximum number of frames to load from the driving video. Set to 0 to use all frames.
120
base64
optionalboolean
Base64 encoding of the output image.
false
crop_drive_face
optionalboolean
Crop the driving face
false
driving_audio
optionalboolean
Set to 'true' to return the audio of the driving video; if 'false', the audio of input video will be returned.
false
eye_retargeting
optionalboolean
Enable eye retargeting
false
eyes_retargeting_multiplier
optionalnumber
Multiplier for eye retargeting
1
Range: 0.01 - 10lip_retargeting
optionalboolean
Enable lip retargeting
false
lip_retargeting_multiplier
optionalnumber
Multiplier for lip retargeting
1
Range: 0.01 - 10lip_zero
optionalboolean
Zero out the lips
true
lip_zero_threshold
optionalnumber
Threshold for zeroing out the lips
0.03
Range: 0 - 5relative
optionalboolean
Use relative method
true
stitching
optionalboolean
Enable stitching
true
vx_ratio
optionalnumber
Horizontal ratio for transformation
0
Range: -1 - 1vy_ratio
optionalnumber
Vertical ratio for transformation
-0.125
Range: -1 - 1Response Type
Returns: Video
Common Error Codes
The API returns standard HTTP status codes. Detailed error messages are provided in the response body.
Bad Request
Invalid parameters or request format
Unauthorized
Missing or invalid API key
Forbidden
Insufficient permissions
Not Found
Model or endpoint not found
Insufficient Credits
Not enough credits to process request
Rate Limited
Too many requests
Server Error
Internal server error
Bad Gateway
Service temporarily unavailable
Timeout
Request timed out