tavus-cvi-quickstart

Tavus CVI クイックスタート

リアルタイムの AI ビデオ会話を数分で開始できます。

最速の方法：標準リソースを使用する

curl -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_url をブラウザーで開くと、通話に参加できます。

標準リソース

レプリカ（ビジュアルアバター）：

• rfe12d8b9597 - デフォルト
• re8e740a42 - Nathan

ペルソナ（振る舞い／性格）：

• pdced222244b - デフォルト
• p24293d6 - 有名 DJ

カスタムペルソナと会話を作成する

ステップ 1：ペルソナを作成する

curl -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"
}

ステップ 2：会話を開始する

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"

主なコンセプト

コンセプト	内容
レプリカ	ビジュアルアバター（顔、外見）
ペルソナ	振る舞い、音声、LLM の設定、システムプロンプト
会話	レプリカとペルソナを組み合わせたライブ WebRTC セッション

パイプラインモード

• full - 認識、STT、LLM、TTS を含む完全な CVI（推奨）
• echo - LLM をバイパスし、送信した内容をレプリカがそのまま話すモード
• audio - ビデオなしの音声のみのモード

レイテンシ

完全なパイプラインで、発話から発話までの応答時間は約 600ms です。

次のステップ

• tavus-cvi-persona - ペルソナ設定を詳しく確認する
• tavus-cvi-ui - React コンポーネントとの統合
• tavus-cvi-interactions - プログラムから会話を制御する
• tavus-cvi-knowledge - ナレッジベースとメモリを追加する