curl --request POST \
  --url https://tavusapi.com/v2/conversations \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "replica_id": "rfe12d8b9597",
  "persona_id": "pdced222244b"
}'

{
  "conversation_id": "c123456",
  "conversation_name": "A Meeting with Hassaan",
  "status": "active",
  "conversation_url": "https://tavus.daily.co/c123456",
  "replica_id": "r79e1c033f",
  "persona_id": "p5317866",
  "created_at": "<string>"
}

Conversation

Create Conversation

This endpoint starts a real-time video conversation with your AI replica, powered by a persona that allows it to see, hear, and respond like a human.

Core Components:

Replica - Choice of audio/visual appearance
Persona - Define the replica’s behavior and capabilities

The response includes a conversation_url that you can use to join the call or embed it on your website. Learn how to embed it here.

If you provide a callback_url, you’ll receive webhooks with updates about the conversation status. Learn more about Callback here.

POST

conversations

curl --request POST \
  --url https://tavusapi.com/v2/conversations \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "replica_id": "rfe12d8b9597",
  "persona_id": "pdced222244b"
}'

{
  "conversation_id": "c123456",
  "conversation_name": "A Meeting with Hassaan",
  "status": "active",
  "conversation_url": "https://tavus.daily.co/c123456",
  "replica_id": "r79e1c033f",
  "persona_id": "p5317866",
  "created_at": "<string>"
}

Required Parameters

Authorizations

x-api-key

string

header

required

Body

application/json

Response

200

application/json

The response is of type object.

Authentication Get Conversation

Introduction

Conversation

Persona

Replica

Video Generation

Speech

Create Conversation

Authorizations

Body

Response