mcpField
T
tavus-replica

tavus-replica

github.com/tavus-engineering创意与媒体958 次安装39 周前更新
代码仓库

关于 tavus-replica

tavus-replica 是用于创建和管理 Tavus 数字分身的技能，可用于视频生成和实时对话。内容涵盖现成分身、自定义训练及分身生命周期操作。

主要功能

  1. 01使用现成分身 ID
  2. 02准备训练视频和同意视频
  3. 03通过 API 创建自定义分身
  4. 04查看训练状态并列出分身
  5. 05通过 API 删除分身

适用场景

  1. 01使用现成分身测试视频生成
  2. 02根据提供的视频训练分身
  3. 03跟踪自定义分身的训练进度
  4. 04删除不再需要的分身

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tavus-engineering/tavus-skills --skill tavus-replica

安装后在 Claude Code 中输入/tavus-replica确认已加载。

详细介绍

Tavus Replica 技能

创建逼真的 AI 数字分身，用于视频生成和实时对话。

库存分身（开箱即用）

无需训练。直接使用以下 ID：

  • rfe12d8b9597 - 默认库存分身
  • re8e740a42 - Nathan

完整列表：https://docs.tavus.io/sections/replica/stock-replicas

创建自定义分身

训练视频要求
  1. 时长：1 分钟讲话 + 1 分钟静默（同一段视频）
  2. 画质：至少 1080p，摄像头稳定并与视线齐平
  3. 光线：柔和均匀，脸部无阴影
  4. 音频：安静的房间内录制，无背景噪音
  5. 取景：脸部至少占画面的 25%
  6. 表情：讲话片段开始时露出灿烂的笑容
  7. 背景：简洁、静止，没有移动的物体或人员
同意视频

个人分身必须提供。录制自己说出以下内容：

"我，[全名]，同意创建自己的数字分身，并将其用于 Tavus 技术。"

可以单独录制，也可以放在训练视频开头。

API：创建分身
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"
}

训练需要 4-6 小时。你会收到 webhook，也可以轮询状态。

API：检查训练状态
curl https://tavusapi.com/v2/replicas/{replica_id} \
  -H "x-api-key: YOUR_API_KEY"

状态值：training、completed、error

API：列出所有分身
curl https://tavusapi.com/v2/replicas \
  -H "x-api-key: YOUR_API_KEY"
API：删除分身
curl -X DELETE https://tavusapi.com/v2/replicas/{replica_id} \
  -H "x-api-key: YOUR_API_KEY"

最佳实践

  • 使用桌面录制应用（QuickTime、Windows Camera），不要使用浏览器
  • 预签名 S3 URL 的有效期必须达到 24 小时以上
  • Phoenix-3 模型为默认选项，且推荐使用
  • 训练自定义分身前，先使用库存分身进行测试

评论

支持 Markdown