mcpField
T
tavus-video-gen

tavus-video-gen

github.com/tavus-engineeringクリエイティブ・メディア965 回インストール39 週間前に更新
リポジトリ

tavus-video-gen について

Tavus API を使って、レプリカに台本を話させたり、提供した音声にリップシンクさせたりするスキルです。背景の指定、動画の状態確認、一覧表示、削除にも対応します。

主な機能

  1. 01台本または音声から動画を生成
  2. 02既存またはカスタムレプリカの選択
  3. 03ウェブサイトや動画の背景を設定
  4. 04透過 WebM の生成
  5. 05動画の状態確認と管理

活用シーン

  1. 01レプリカによる製品デモの作成
  2. 02録音したナレーションのリップシンク動画化
  3. 03ウェブサイトや動画を背景にした動画の生成
  4. 04生成動画の状態確認や削除

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/tavus-video-genを入力して読み込まれたか確認します。

詳細

Tavus 動画生成スキル

スクリプトを話すレプリカで、パーソナライズされた AI 動画を生成します。

クイックスタート

curl -X POST https://tavusapi.com/v2/videos \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "replica_id": "rfe12d8b9597",
    "script": "Hey there! Welcome to our product demo."
  }'

レスポンス：

{
  "video_id": "1e30440cf9",
  "status": "queued"
}

API オプションの詳細

curl -X POST https://tavusapi.com/v2/videos \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "replica_id": "rfe12d8b9597",
    "script": "Your script text here",
    "video_name": "Product Demo v1",
    "callback_url": "https://your-webhook.com/video-ready",
    "background_url": "https://example.com/landing-page",
    "background_source_url": "https://s3.../background.mp4",
    "watermark_url": "https://s3.../logo.png",
    "fast": false,
    "transparent_background": false
  }'
パラメーター
パラメーター説明
replica_id必須。ストックまたはカスタムのレプリカ ID
scriptレプリカに話させるテキスト（audio_url とのいずれかを使用）
audio_urlレプリカのリップシンクに使用する録音済み音声（.wav/.mp3）
video_name表示名
callback_url完了時／エラー時の Webhook
background_url背景として録画する Web サイトの URL
background_source_url背景用の動画ファイル URL
watermark_urlPNG/JPEG ロゴのオーバーレイ
fast高速レンダリング（一部の機能を無効化）
transparent_backgroundアルファ付き WebM（fast: true が必要）

スクリプトの代わりに音声を使用する

{
  "replica_id": "rfe12d8b9597",
  "audio_url": "https://s3.../narration.mp3"
}

対応形式：.wav、.mp3

背景オプション

Web サイトの背景

スクロールする Web サイトを背景として録画します：

{
  "background_url": "https://example.com/landing-page"
}
動画の背景

動画ファイルを使用します：

{
  "background_source_url": "https://s3.../promo-bg.mp4"
}
透明な背景

動画編集ソフトで合成する場合に使用します：

{
  "fast": true,
  "transparent_background": true
}

アルファチャンネル付きの .webm を出力します。

動画のステータスを確認する

curl https://tavusapi.com/v2/videos/{video_id} \
  -H "x-api-key: YOUR_API_KEY"

ステータスの値：queued、generating、ready、error、deleted

準備完了時：

{
  "status": "ready",
  "hosted_url": "https://videos.tavus.io/video/xxx",
  "download_url": "https://stream.mux.com/.../high.mp4",
  "stream_url": "https://stream.mux.com/xxx.m3u8"
}

Webhook コールバック

完了時：

{
  "video_id": "1e30440cf9",
  "status": "ready",
  "hosted_url": "https://videos.tavus.io/video/1e30440cf9",
  "download_url": "...",
  "stream_url": "..."
}

エラー時：

{
  "video_id": "xxx",
  "status": "error",
  "status_details": "Error message here"
}

スクリプト作成のベストプラクティス

  • 品質とエンゲージメントを保つため、5 分以内にします
  • 会話調で書きます（声に出してテストします）
  • 句読点で間を示します
  • 明確な構成にします：導入 → 本文 → CTA
  • 長いコンテンツは複数の動画に分けます

動画の一覧表示と削除

# List all videos
curl https://tavusapi.com/v2/videos -H "x-api-key: YOUR_API_KEY"

# Delete video
curl -X DELETE https://tavusapi.com/v2/videos/{video_id} \
  -H "x-api-key: YOUR_API_KEY"

コメント

Markdown 対応