Loading...
Loading...
Quick start guide for Tavus Conversational Video Interface (CVI). Use when starting a real-time video conversation, creating your first persona, or testing the CVI API. Covers the minimal setup to get a conversation running.
npx skill4agent add tavus-engineering/tavus-skills tavus-cvi-quickstartcurl -X POST https://tavusapi.com/v2/conversations \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"replica_id": "rfe12d8b9597",
"persona_id": "pdced222244b"
}'{
"conversation_id": "c123456",
"conversation_url": "https://tavus.daily.co/c123456",
"status": "active"
}conversation_urlrfe12d8b9597re8e740a42pdced222244bp24293d6curl -X POST https://tavusapi.com/v2/personas \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"persona_name": "Sales Coach",
"pipeline_mode": "full",
"system_prompt": "You are a friendly sales coach helping reps practice cold calls. Ask probing questions and give constructive feedback.",
"context": "Focus on B2B SaaS sales scenarios.",
"default_replica_id": "rfe12d8b9597"
}'{
"persona_id": "p123456",
"persona_name": "Sales Coach"
}curl -X POST https://tavusapi.com/v2/conversations \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"persona_id": "p123456",
"conversation_name": "Practice Session"
}'{
"persona_id": "p123456",
"replica_id": "rfe12d8b9597",
"conversation_name": "Demo Call",
"conversational_context": "User is interested in enterprise pricing.",
"custom_greeting": "Hi! I'm excited to help you today.",
"callback_url": "https://your-webhook.com/tavus",
"properties": {
"enable_recording": true,
"max_duration": 600
}
}curl -X POST https://tavusapi.com/v2/conversations/{conversation_id}/end \
-H "x-api-key: YOUR_API_KEY"| Concept | What it is |
|---|---|
| Replica | The visual avatar (face, appearance) |
| Persona | Behavior, voice, LLM config, system prompt |
| Conversation | A live WebRTC session combining replica + persona |
fullechoaudio