> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# LiveAvatar

## 概要

LiveAvatarインテグレーションは、ElevenAgentsとHeyGenの[LiveAvatar](https://docs.liveavatar.com)プラットフォームを接続し、インタラクティブなアバター体験を実現します。このインテグレーションでは、ElevenLabs Agents（音声インタラクションを処理）とLiveAvatarのリアルタイムアバタービデオストリーミングを組み合わせ、AIアバターとの低レイテンシーなビジュアル会話を可能にします。

このインテグレーションでは、次のことができます。

* 視覚的なアバター表現を備えた会話型AIエージェントをデプロイする
* リアルなアバターによるインタラクティブなカスタマーサービス体験を作成する
* ウェブサイトやアプリケーション向けの魅力的なバーチャルアシスタントを構築する

## 仕組み

このインテグレーションでは、LiveAvatarのLITEセッションモードを使用します。このモードでは、2つのプラットフォームで役割を分担します。

* **ElevenLabs**：音声入力と出力のストリーミングおよびオーケストレーションを処理
* **LiveAvatar**：アバターのレンダリングとリアルタイムビデオストリーミングを管理

ElevenAgents設定でLITEモードセッションを開始すると、LiveAvatarはElevenLabsエージェントに接続するワーカーをディスパッチします。エージェントの音声出力が、アバターのリップシンクとアニメーションをリアルタイムで駆動します。

```mermaid
sequenceDiagram
    participant User
    participant LiveAvatar
    participant ElevenLabs Agent

    User->>LiveAvatar: Start LITE session with agent config
    LiveAvatar->>ElevenLabs Agent: Connect worker to agent
    User->>ElevenLabs Agent: Audio input (speech)
    ElevenLabs Agent->>ElevenLabs Agent: Audio orchestration + LLM
    ElevenLabs Agent->>LiveAvatar: Audio output
    LiveAvatar->>User: Avatar video stream with lip sync
```

## 前提条件

インテグレーションを設定する前に、以下をご用意ください。

1. APIアクセス権のあるElevenLabsアカウント
2. APIアクセス権のあるHeyGen LiveAvatarアカウント
3. ElevenLabsエージェント（[クイックスタートガイド](/docs/ja/eleven-agents/quickstart)に従って作成）

> **Note**
>
> ElevenLabs Agentでは、音声入力および出力フォーマットをPCM 24000 Hzに設定する必要があります。これは、
> Voice settings＞TTS output formats、およびAdvanced＞User input audio formatで設定できます。

## セットアップ

#### ElevenLabs認証情報を取得

ElevenLabsアカウントから、次の2つが必要です。

1. **エージェントID**：[Agents Platform ＞ Agents](https://elevenlabs.io/app/agents/agents)に移動し、使用するエージェントのIDをコピーします

2. **APIキー**：[Settings ＞ API Keys](https://elevenlabs.io/app/settings/api-keys)に移動し、新しいAPIキーを生成します（または既存のキーを使用します）

> **Note**
>
> APIキーには、`convai_read`、`user_read`、`voices_read`の権限が必要です。

#### ElevenLabs APIキーをLiveAvatarに登録

LiveAvatarでは、secretsエンドポイントを通じてElevenLabs APIキーを登録する必要があります。この登録により、Amazon KMSを使用してキーが暗号化され、セッションで使用する`secret_id`が返されます。

LiveAvatarのsecretsエンドポイントにPOSTリクエストを送信します。

```bash
curl -X POST "https://api.liveavatar.com/v1/secrets" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: <your_heygen_api_key>" \
  -d '{
    "secret_type": "ELEVENLABS_API_KEY",
    "secret_value": "<your_secret_value>",
    "secret_name": "<your_secret_name>"
  }'
```

レスポンスには`secret_id`が含まれます。セッション開始時に使用するため、この`secret_id`を保存してください。

#### LiveAvatarセッションを開始

LiveAvatarセッションを開始する際は、LITEモードを使用し、ElevenAgents設定を含めます。

```json
{
  "mode": "LITE",
  "elevenlabs_agent_config": {
    "secret_id": "xxxxxxxxxxxxxxxx",
    "agent_id": "agent_xxxxxxxxxxxxxxxx"
  },
  "avatar_id": "xxxxx"
}
```

セッション管理の詳細については、[LiveAvatarセッションAPIドキュメント](https://docs.liveavatar.com)を参照してください。

## イベントとコールバック

このインテグレーションは、LiveAvatarのFULLモードと同じイベント構造を使用して、LiveKitルーム経由でイベントを配信します。これにより、次のことができます。

* 会話状態の変化を監視する
* エージェントの発話・リスニングモードを追跡する
* 接続および切断イベントを処理する
* 文字起こしとエージェントの応答を処理する

イベントハンドラーは、[LiveAvatarイベントドキュメント](https://docs.liveavatar.com)に従って設定してください。

## 料金

このインテグレーションでは、両プラットフォームからそれぞれ料金が請求されます。

| コンポーネント             | 料金                                                                       |
| ------------------- | ------------------------------------------------------------------------ |
| LiveAvatar（アバタービデオ） | セッション1分あたり1クレジット                                                         |
| ElevenLabs（会話型AI）   | [サブスクリプションプラン](https://elevenlabs.io/pricing)に基づき、ElevenLabsアカウントに請求されます |

アバターストリーミングの料金はビデオコンポーネントに対してのみ請求され、エージェントのすべての利用分（音声とLLM）はElevenLabsアカウントを通じて別途請求されます。

## リソース

* [LiveAvatar ElevenLabs Agentプラグインのドキュメント](https://docs.liveavatar.com/docs/elevenlabs-agent-plugin)
* [LiveAvatar APIリファレンス](https://docs.liveavatar.com/reference)
* [ElevenAgentsクイックスタート](/docs/ja/eleven-agents/quickstart)
* [ElevenAgents APIリファレンス](/docs/ja/api-reference/agents/create)