用途:帮助开发者快速上手 Tavus 对话式视频接口(CVI),在几分钟内跑通一场实时 AI 视频对话,适合首次创建 persona 或测试实时视频会话的场景。
主要能力:提供最快路径——直接调用会话接口,使用官方现成资源即可开始。现成 Replica(视觉形象)包括 rfe12d8b9597(默认)、re8e740a42(Nathan);现成 Persona(行为/性格)包括 pdced222244b(默认)、p24293d6(Celebrity DJ)。也可先创建自定义 Persona,再发起会话。
使用方式:发起会话使用 POST https://tavusapi.com/v2/conversations,请求头带 Content-Type: application/json 与 x-api-key: YOUR_API_KEY,请求体传入 replica_id 和 persona_id。返回 conversation_id、conversation_url 和 status,在浏览器打开 conversation_url 即可加入通话。创建 Persona 使用 POST https://tavusapi.com/v2/personas,可设置 persona_name、pipeline_mode、system_prompt、context、default_replica_id。会话可选参数包括 conversation_name、conversational_context、custom_greeting、callback_url,以及 properties 中的 enable_recording、max_duration。结束会话使用 POST https://tavusapi.com/v2/conversations/{conversation_id}/end,请求头带 x-api-key。
关键概念:Replica 是视觉形象(脸、外观);Persona 是行为、声音、LLM 配置与系统提示;Conversation 是结合二者的实时 WebRTC 会话。Pipeline 模式有 full(含感知、STT、LLM、TTS,推荐)、echo(绕过 LLM,直接朗读发送内容)、audio(仅音频无视频)。full 流水线下语句到语句响应延迟约 600ms。
限制:资料未提供收费、价格、平台支持范围及配额等信息,暂未提供。后续可参考 tavus-cvi-persona、tavus-cvi-ui、tavus-cvi-interactions、tavus-cvi-knowledge 等主题深入了解。