tavus-replica

Tavus レプリカスキル

動画生成やリアルタイムの会話に使用する、リアルな AI デジタルツインを作成します。

ストックレプリカ（すぐに使用可能）

トレーニングは不要です。次の ID をそのまま使用してください。

• rfe12d8b9597 - デフォルトのストックレプリカ
• re8e740a42 - Nathan

全リスト：https://docs.tavus.io/sections/replica/stock-replicas

カスタムレプリカを作成する

トレーニング動画の要件

1. 長さ：会話を1分間＋無音を1分間（同じ動画）
2. 画質：最低1080p、目の高さでカメラを固定
3. 照明：拡散した均一な照明で、顔に影がかからないこと
4. 音声：静かな部屋で、背景ノイズがないこと
5. フレーミング：顔がフレームの少なくとも25%を占めること
6. 表情：会話部分は満面の笑みで始めること
7. 背景：シンプルで静止しており、動く物や人がいないこと

同意動画

個人レプリカには同意動画が必要です。次のように話している自分を録画してください。

"I, [full name], consent to the creation of a digital replica of my likeness for use with Tavus technology."

別の動画として録画するか、トレーニング動画の冒頭に含めてください。

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 モデルがデフォルトであり、推奨されています
• カスタムレプリカをトレーニングする前に、ストックレプリカでテストしてください