Background Customizations

Customize Background in Conversation Setup

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 apply the green screen background, set the apply_greenscreen 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": {
    "apply_greenscreen": true
   }
}'

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

Step 2: Customize the Background

The above request will return the following 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"
}

The face will appear with a green background. You can customize it on the frontend using WebGL. This allows you to apply a different color or add a custom image.

To preview this feature, try our Green Screen Sample App. Paste the conversation URL to modify the background.

Closed Captions Private Rooms

⌘I

​Customize Background in Conversation Setup

Step 1: Create Your Conversation

Step 2: Customize the Background

Customize Background in Conversation Setup