Tavus Replica Skill 用于创建和管理 Tavus 的 AI 数字分身(replica),面向视频生成与实时对话场景。
用途 该技能覆盖两类 replica 的使用:一是可直接使用的预置 stock replica,二是从视频训练得到的自定义 replica。适用于需要以特定人物形象生成视频或进行实时对话的场景。
主要能力
- 预置 stock replica:无需训练,可直接使用其 ID。资料给出的示例包括 rfe12d8b9597(默认 stock replica)和 re8e740a42(Nathan)。完整列表见 https://docs.tavus.io/sections/replica/stock-replicas。
- 创建自定义 replica:通过 API 提交训练视频和同意视频,训练完成后得到专属 replica。
- 管理 replica:查询训练状态、列出全部 replica、删除 replica。
使用方式 创建自定义 replica 前需准备训练视频,要求如下:
- 时长:同一视频中包含 1 分钟说话 + 1 分钟静默。
- 画质:最低 1080p,机位稳定并位于眼睛高度。
- 光照:漫射、均匀,面部无阴影。
- 音频:环境安静,无背景噪音。
- 构图:面部至少占画面 25%。
- 表情:说话片段以大笑开始。
- 背景:简洁、静止,无移动物体或人物。
个人 replica 还需同意视频,需本人说出:"I, [full name], consent to the creation of a digital replica of my likeness for use with Tavus technology." 该视频可单独录制,也可放在训练视频开头。
API 调用示例:
创建 replica:
curl -X POST https://tavusapi.com/v2/replicas
-H "Content-Type: application/json"
-H "x-api-key: YOUR_API_KEY"
-d '{
"replica_name": "My Avatar",
"train_video_url": "https://s3.../train.mp4",
"consent_video_url": "https://s3.../consent.mp4",
"callback_url": "https://your-webhook.com/tavus"
}'
返回示例: { "replica_id": "r783537ef5", "status": "training", "training_progress": "0/100" }
查询训练状态:
curl https://tavusapi.com/v2/replicas/{replica_id}
-H "x-api-key: YOUR_API_KEY"
状态值包括 training、completed、error。
列出全部 replica:
curl https://tavusapi.com/v2/replicas
-H "x-api-key: YOUR_API_KEY"
删除 replica:
curl -X DELETE https://tavusapi.com/v2/replicas/{replica_id}
-H "x-api-key: YOUR_API_KEY"
适用场景
- 需要以固定人物形象批量生成视频。
- 需要用于实时对话的 AI 数字分身。
- 在训练自定义 replica 前,先用 stock replica 进行测试。
限制与注意事项
- 训练耗时约 4-6 小时,需通过 webhook 或轮询获取状态。
- 建议使用桌面录制应用(如 QuickTime、Windows Camera),而非浏览器录制。
- 预签名 S3 URL 有效期需在 24 小时以上。
- Phoenix-3 模型为默认且推荐使用。
- 建议先用 stock replica 测试,再训练自定义 replica。
- 关于收费、价格、平台支持范围等信息,资料暂未提供。