TAtavus
Lipsync

Create Lipsync

Changed on

This endpoint is no longer supported by Tavus.

Create a new lipsync video by providing a video URL and an audio URL. The service will synchronize the speaker's mouth movements with the provided audio.

post/v2/lipsync

Request

  • Base URL
    https://tavusapi.com
  • URL
    https://tavusapi.com/v2/lipsync
  • Auth
    API key in header x-api-key

Request body

original_video_urlstring required

A direct link to the video that will be modified. This should be a publicly accessible / presigned S3 URL.

source_audio_urlstring required

A direct link to the audio file that will be synchronized with the video. This should be a publicly accessible / presigned S3 URL.

lipsync_namestring

An optional name for the lipsync video.

callback_urlstring

A url that will receive a callback on completion of the lipsync or on error.

Example request

{
  "original_video_url": "https://example.com/video.mp4",
  "source_audio_url": "https://example.com/audio.mp3",
  "lipsync_name": "My Lipsync Video",
  "callback_url": "https://your-callback-url.com"
}

Response

lipsync_idstring

A unique identifier for the lipsync request.

lipsync_namestring nullable

The name of the lipsync request.

statusstring

The status of the lipsync request.

callback_urlstring

The callback URL that will receive notifications about the lipsync request.

request_idstring

Legacy field - will be removed soon. Use lipsync_id instead.

request_namestring

Legacy field - will be removed soon. Use lipsync_name instead.

Example response

{
  "lipsync_id": "wf85407a7ba9d",
  "lipsync_name": "My Lipsync Video",
  "status": "started",
  "callback_url": "https://your-callback-url.com",
  "request_id": "wf85407a7ba9d",
  "request_name": "My Lipsync Video"
}

Changes