Vozo Help Center

The LipSync API creates a lip-synced video or talking photo by synchronizing facial movements in a reference video or image with the driving audio. Choose Standard mode for faster processing or Precision mode for higher-quality results.

Inputs

Field	Values	Requirement	Description
`reference_file_url`	Publicly accessible video or image URL	Required	Supports `.mp4`, `.mov`, `.webm`, `.avi`, and `.wmv` videos, and `.jpg`, `.jpeg`, `.png`, and `.webp` images.
`reference_file_type`	`video`, `image`	Required	Specifies whether the reference file is a video or image.
`model`	`standard_v1`, `precision_v1`	Required	`standard_v1` processes faster, while `precision_v1` provides higher quality.
`audio_url`	Publicly accessible audio URL	Conditional; required for image references	For video references, omit it to use the video’s original audio, or provide it to replace the original audio. Supports `.wav`, `.mp3`, and `.m4a`.
`callback_url`	URL	Optional	Receives a webhook whenever the job status changes.

Outputs

lip-synced video URL

How it works

Host your assets at a publicly accessible URL

Upload your video, photo, and audio files so our servers can retrieve them.

Send an API request

Provide the required inputs and any optional settings needed for the job.

Wait or query status

Use our webhook callback or poll the API with your job ID until processing is complete.

Download video output

Retrieve the finished talking photo or lip‑synced video from the provided URL.

Usage Limitation:

The default concurrency limit is 10 jobs. The limit is shared by all members of a team. See Concurrency limits for details.
Only single‑face videos or photos are supported.
Estimated queue time: 1–120 minutes, depending on system load.
Standard Mode processing time: ~10 minutes.
Precision Mode processing time: ~20 minutes.

If a video or photo contains multiple faces, only the largest detected face will be lip‑synced.

API Error Codes

Code	Description
5	Invalid request parameters.
7	No permission to request.
104	Insufficient credits.
814	Your account is not a member and is not allowed to call the API.
1000	Internal Server Error.
1301	Callback Challenge failed.
1302	API key has been revoked.
1304	API key has reached the maximum number of concurrent requests.
1502	Your audio driver is either invalid or cannot be downloaded.
1503	Your account is not authorized to call the API.
1305	Only Studio plan is allowed.

Job Error Codes

Code	Description
999	Failed to download the file.
20403	Not enough faces.
20407	The number of face tracks is too many.
20408	The image-to-video facial detection has not been passed.
20601	There are no faces in the picture.
20602	Unknown image format.
20611	Video triggering flow limit.
20613	Generate video input sensitive to images.

Overview

Translate & Dub API

Visual Translate API

LipSync API

Reusable LipSync API

Overview

Inputs

Outputs

How it works

Usage Limitation:

API Error Codes

Job Error Codes

​Inputs

​Outputs

​How it works

​Usage Limitation:

​API Error Codes

​Job Error Codes

Inputs

Outputs

How it works

Usage Limitation:

API Error Codes

Job Error Codes