Closed Captions

Enable Captions in Real Time During the Conversation

Step 1: Create Your Conversation

In this example, we will use stock face ID r90bbd427f71 (Anna) and stock PAL ID pcb7a34da5fe (Sales Development Rep).

To enable closed captions, set the enable_closed_captions parameter to true when creating the conversation:

cURL

curl --request POST \
  --url https://tavusapi.com/v2/conversations \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api_key>' \
  --data '{
  "pal_id": "pcb7a34da5fe",
  "face_id": "r90bbd427f71",
  "callback_url": "https://yourwebsite.com/webhook",
  "conversation_name": "Improve Sales Technique",
  "conversational_context": "I want to improve my sales techniques. Help me practice handling common objections from clients and closing deals more effectively.",
  "properties": {
    "enable_closed_captions": true
   }
}'

Replace <api_key> with your actual API key. You can generate one in the PAL Maker.

Step 2: Join the Conversation

To join the conversation, click the link in the conversation_url field from the response:

{
  "conversation_id": "ca4301628cb9",
  "conversation_name": "Improve Sales Technique",
  "conversation_url": "<conversation_link>",
  "status": "active",
  "callback_url": "https://yourwebsite.com/webhook",
  "created_at": "2025-05-13T06:42:58.291561Z"
}

Closed captions will appear during the conversation whenever you or the PAL speaks.

Call Duration and Timeout Background Customizations

⌘I

​Enable Captions in Real Time During the Conversation

Step 1: Create Your Conversation

Step 2: Join the Conversation

Enable Captions in Real Time During the Conversation