Prerequisites

Before using the Lipsync service, make sure your input files meet the following requirements:
  • File Requirements:
    • Video: .mp4 format, max 5 minutes.
    • Audio: .mp3 or .wav format, max 5 minutes.
  • Quality Recommendations:
    • The video should clearly show the speaker’s mouth, facing the camera (“talking head” style).
    • Avoid cartoon or animated characters.
    • Use good lighting and minimal background clutter.
    • Audio should be clear, well-recorded, and free of background noise.
    • Use single-speaker, natural speech (avoid singing, whispering, or overlapping voices).
Ensure that the URLs you provide for the video and audio files are publicly accessible.

Create a Lip Sync Video

1

Step 1: Create a Lip-sync Video

Use the following request to start processing the video:
original_video_url and source_audio_url are required.
curl --request POST \
  --url https://tavusapi.com/v2/lipsync \
  -H "Content-Type: application/json" \
  -H "x-api-key: <api-key>" \
  -d '{
    "original_video_url": "<your_original_video_url>",
    "source_audio_url": "<your_source_audio_url>",
    "lipsync_name": "<your_lipsync_name>",
    "callback_url": "<your_callback_url>"
}'
  • Replace <api_key> with your actual API key. You can generate one in the Developer Portal.
  • Replaca <your_original_video_url>" with the downloadable URL of your original video.
  • Replaca <your_source_audio_url> with the downloadable URL of your source audio.
  • Replace <your_lipsync_name> with the name for your lip-sync video.
  • Replace <your_callback_url> with your callback URL.
2

Step 2: Check Video Status

You can monitor the processing status using the Get Lipsync endpoint:
curl --request GET \
  --url https://tavusapi.com/v2/lipsync/{lipsync_id} \
  --header 'x-api-key: <api-key>'
Replace <api_key> with your actual API key.
3

Step 3: Download the Video

Once the video is generated, you’ll receive a response containing the video_url. Use this URL to download your video.
200
{
  "request_id": "<your_request_id>",
  "name": "<your_lipsync_name>",
  "status": "completed",
  "created_at": "Tue, 24 Jun 2025 07:23:36 GMT",
  "lipsync_id": "<your_lipsync_id>",
  "lipsync_name": "<your_lipsync_name>",
  "video_url": "<your_video_url>"
}
The download link for your video expires after 1 week. To get a new download link, use the Get Lipsync endpoint.