tavus-cvi-persona

Tavus CVI Persona 配置

对 Persona 行为、大模型、TTS、感知和轮次交接进行深度配置。

完整 Persona 架构

curl -X POST https://tavusapi.com/v2/personas \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "persona_name": "Technical Interviewer",
    "pipeline_mode": "full",
    "system_prompt": "You are a senior technical interviewer...",
    "context": "Focus on system design and coding problems.",
    "default_replica_id": "rfe12d8b9597",
    "layers": {
      "llm": {...},
      "tts": {...},
      "perception": {...},
      "stt": {...}
    }
  }'

大模型层

内置模型（经过优化）

{
  "layers": {
    "llm": {
      "model": "tavus-gpt-4o"
    }
  }
}

选项：tavus-gpt-4o、tavus-gpt-4o-mini、tavus-llama

自带大模型

任何兼容 OpenAI 的 API：

{
  "layers": {
    "llm": {
      "model": "gpt-4-turbo",
      "base_url": "https://api.openai.com/v1",
      "api_key": "sk-...",
      "speculative_inference": true
    }
  }
}

适用于：OpenAI、Anthropic（通过代理）、Groq、Together，以及具有兼容 OpenAI 端点的本地模型。

函数调用 / 工具

{
  "layers": {
    "llm": {
      "model": "tavus-gpt-4o",
      "tools": [
        {
          "type": "function",
          "function": {
            "name": "get_weather",
            "description": "Get current weather for a location",
            "parameters": {
              "type": "object",
              "properties": {
                "location": {
                  "type": "string",
                  "description": "City and state"
                }
              },
              "required": ["location"]
            }
          }
        }
      ]
    }
  }
}

工具调用通过 Interactions Protocol 发送。

TTS 层

Cartesia（默认）

{
  "layers": {
    "tts": {
      "tts_engine": "cartesia",
      "voice_id": "your-cartesia-voice-id"
    }
  }
}

ElevenLabs

{
  "layers": {
    "tts": {
      "tts_engine": "elevenlabs",
      "voice_id": "your-elevenlabs-voice-id",
      "api_key": "your-elevenlabs-key"
    }
  }
}

PlayHT

{
  "layers": {
    "tts": {
      "tts_engine": "playht",
      "voice_id": "your-playht-voice-id",
      "api_key": "your-playht-key"
    }
  }
}

感知层（Raven）

使副本能够“看见”——分析表情、视线、背景和屏幕内容。

{
  "layers": {
    "perception": {
      "perception_model": "raven-0",
      "ambient_awareness": true
    }
  }
}

用例：

• 对用户的表情 / 情绪做出反应
• 查看共享屏幕
• 分析用户所处的环境

STT 层（语音识别）

智能轮次检测（Sparrow）

{
  "layers": {
    "stt": {
      "smart_turn_detection": true,
      "participant_pause_sensitivity": "medium",
      "participant_interrupt_sensitivity": "medium"
    }
  }
}

灵敏度选项：low、medium、high

• pause_sensitivity：用户暂停多久后副本才会回应
• interrupt_sensitivity：用户打断副本的难易程度

管线模式

Full（默认）

包含所有层的完整管线：

{ "pipeline_mode": "full" }

Echo

绕过大模型——副本会原样说出你发送的内容：

{ "pipeline_mode": "echo" }

与 Interactions Protocol 配合使用，可直接控制语音。

Audio Only

仅语音，无视频：

{
  "pipeline_mode": "full",
  "audio_only": true
}

更新现有 Persona

curl -X PATCH https://tavusapi.com/v2/personas/{persona_id} \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "system_prompt": "Updated prompt...",
    "context": "New context..."
  }'

列出和删除 Persona

# List
curl https://tavusapi.com/v2/personas -H "x-api-key: YOUR_API_KEY"

# Delete
curl -X DELETE https://tavusapi.com/v2/personas/{persona_id} \
  -H "x-api-key: YOUR_API_KEY"

支持的语言

通过 Cartesia + ElevenLabs 备用方案支持 30 多种语言： 英语、法语、德语、西班牙语、葡萄牙语、中文、日语、印地语、意大利语、韩语、荷兰语、波兰语、俄语、瑞典语、土耳其语、印度尼西亚语、菲律宾语、阿拉伯语、捷克语、希腊语、芬兰语、克罗地亚语、丹麦语、泰米尔语、乌克兰语、匈牙利语、挪威语、越南语等。