- Endpoint:
POST /v3/lipsyncs - Purpose: Dub or replace audio on a video. The job runs asynchronously: poll via Get Lipsync or use a
callback_url(Webhooks). - For higher fidelity, see Precision mode. For many videos in one job, see Lipsync batches.
Quick Example
video and audio accept a publicly accessible HTTPS link ({ "type": "url", "url": "..." }) or a file uploaded via POST /v3/assets ({ "type": "asset_id", "asset_id": "..." }, see Upload Assets). The response returns a lipsync_id.
Optional fields cover captions, music stripping, speech enhancement, watermarking, partial lipsync with start_time and end_time, keep_the_same_format (preserve source resolution and bitrate), fps_mode ("vfr", "cfr" or "passthrough"), folder_id, and callback_url / callback_id. enable_dynamic_duration (default true) lets output duration adjust to the new audio length. See the create reference for the full list.
Manage Lipsyncs
- Get:
GET /v3/lipsyncs/{lipsync_id}.statusmovespending→running→completed|failed. The presignedvideo_urlanddurationappear oncompleted;failure_messageappears onfailed. - List:
GET /v3/lipsyncswithlimit(1–100, default10) and thetokencursor, paged withhas_moreandnext_token. - Update:
PATCH /v3/lipsyncs/{lipsync_id}changes thetitle. - Delete:
DELETE /v3/lipsyncs/{lipsync_id}permanently deletes a lipsync.
CLI Usage
The CLI wraps every call and can poll for you with--wait:

