SuperAPI AI 工具集

tavus-replica

智能体与模型

查看项目

更新于 10-16 01:58

技能介绍

Tavus Replica Skill 用于创建和管理 Tavus 的 AI 数字分身(replica),面向视频生成与实时对话场景。

用途 该技能覆盖两类 replica 的使用:一是可直接使用的预置 stock replica,二是从视频训练得到的自定义 replica。适用于需要以特定人物形象生成视频或进行实时对话的场景。

主要能力

  1. 预置 stock replica:无需训练,可直接使用其 ID。资料给出的示例包括 rfe12d8b9597(默认 stock replica)和 re8e740a42(Nathan)。完整列表见 https://docs.tavus.io/sections/replica/stock-replicas。
  2. 创建自定义 replica:通过 API 提交训练视频和同意视频,训练完成后得到专属 replica。
  3. 管理 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。
  • 关于收费、价格、平台支持范围等信息,资料暂未提供。