Back to Details

tavus-replica

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Tavus Replica Skill

Tavus Replica 技能

Create lifelike AI digital twins for video generation and real-time conversations.
为视频生成和实时对话创建逼真的AI数字孪生体。

Stock Replicas (Ready to Use)

库存分身（可直接使用）

No training needed. Use these IDs directly:
  • rfe12d8b9597
    - Default stock replica
  • re8e740a42
    - Nathan
Full list: https://docs.tavus.io/sections/replica/stock-replicas
无需训练。可直接使用以下ID：
  • rfe12d8b9597
    - 默认库存分身
  • re8e740a42
    - Nathan
完整列表：https://docs.tavus.io/sections/replica/stock-replicas

Create Custom Replica

创建自定义分身

Training Video Requirements

训练视频要求

  1. Duration: 1 min talking + 1 min silence (same video)
  2. Quality: 1080p minimum, stable camera at eye level
  3. Lighting: Diffuse, even lighting, no shadows on face
  4. Audio: Silent room, no background noise
  5. Framing: Face fills at least 25% of frame
  6. Expression: Start talking segment with a big smile
  7. Background: Simple, static, no moving objects/people
  1. 时长：1分钟讲话 + 1分钟静音（同一段视频）
  2. 画质：最低1080p，摄像头稳定且与视线齐平
  3. 光线：柔和均匀的光线，面部无阴影
  4. 音频：安静的房间，无背景噪音
  5. 取景：面部至少占画面的25%
  6. 表情：讲话片段以大大的微笑开场
  7. 背景：简洁、静态，无移动物体/人物

Consent Video

同意视频

Required for personal replicas. Record yourself saying:
"I, [full name], consent to the creation of a digital replica of my likeness for use with Tavus technology."
Can be separate video or at start of training video.
个人分身必须提供。请录制自己说出以下内容：
"我，[全名]，同意使用Tavus技术创建我的肖像数字分身。"
可以是单独的视频，也可以放在训练视频的开头。

API: Create Replica

API：创建分身

bash
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"
  }'
Response:
json
{
  "replica_id": "r783537ef5",
  "status": "training",
  "training_progress": "0/100"
}
Training takes 4-6 hours. You'll receive a webhook or poll status.
bash
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"}'
响应：
json
{
  "replica_id": "r783537ef5",
  "status": "training",
  "training_progress": "0/100"
}
训练耗时4-6小时。你将通过webhook收到通知，也可以主动轮询状态。

API: Check Training Status

API：检查训练状态

bash
curl https://tavusapi.com/v2/replicas/{replica_id} \
  -H "x-api-key: YOUR_API_KEY"
Status values: 
training
, 
completed
, 
error
bash
curl https://tavusapi.com/v2/replicas/{replica_id} \
  -H "x-api-key: YOUR_API_KEY"
状态值：
training
、
completed
、
error

API: List All Replicas

API：列出所有分身

bash
curl https://tavusapi.com/v2/replicas \
  -H "x-api-key: YOUR_API_KEY"
bash
curl https://tavusapi.com/v2/replicas \
  -H "x-api-key: YOUR_API_KEY"

API: Delete Replica

API：删除分身

bash
curl -X DELETE https://tavusapi.com/v2/replicas/{replica_id} \
  -H "x-api-key: YOUR_API_KEY"
bash
curl -X DELETE https://tavusapi.com/v2/replicas/{replica_id} \
  -H "x-api-key: YOUR_API_KEY"

Best Practices

最佳实践

  • Use desktop recording apps (QuickTime, Windows Camera) not browser
  • Pre-signed S3 URLs must be valid for 24+ hours
  • Phoenix-3 model is default and recommended
  • Test with stock replicas before training custom ones
  • 使用桌面录制应用（QuickTime、Windows相机）而非浏览器
  • 预签名S3 URL的有效期必须在24小时以上
  • Phoenix-3模型为默认推荐模型
  • 在训练自定义分身前先使用库存分身进行测试