> 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.

# リアルタイムモデル

## 概要

リアルタイムモデルは、低レイテンシーの音声会話向けに構築され、音声エージェントで利用できるElevenLabsモデルです。

すべての音声エージェントには、**音声モード**として**カスタム**または**リアルタイム**があります。カスタムモードでは、[モデル](/docs/ja/eleven-agents/customization/llm)で説明されているように、LLM、TTSモデル、ASR設定を自分で選択します。リアルタイムモードでは、リアルタイムモデルを選択すると、ElevenLabsがそれらの設定を管理します。

利用可能なリアルタイムモデルは2種類です。

| モデル                         | `realtime_model`の値        | 説明                                                      |
| --------------------------- | ------------------------- | ------------------------------------------------------- |
| **Eleven Realtime v1 Mini** | `eleven_realtime_v1_mini` | デフォルトのリアルタイムモデル。レイテンシーとコストが最も低くなります。                    |
| **Eleven Realtime v1 Max**  | `eleven_realtime_v1_max`  | 応答前に推論を行うため、複雑な指示や複数ステップのツール利用に適しています。Miniよりコストが高くなります。 |

エージェントのシステムプロンプト、音声、ツール、ナレッジベース、ターン設定は、どちらのモードでも同じように機能します。

> **Tip**
>
> SpaceXAIやOpenAIなど、別のリアルタイムAPIから移行しますか？[リアルタイム API](/docs/ja/eleven-agents/guides/openai-realtime-compatibility)を使うと、リアルタイムモデルをよりすばやく試せます。既存のクライアントをElevenLabsに向けるだけで、すでに使用しているイベントをそのまま利用できます。

> **Note**
>
> リアルタイムモデルは段階的に提供されています。エージェントの**Agent**タブに**音声モード**設定が表示されない場合、
> リアルタイムモデルはまだワークスペースで利用できません。また、APIでは`realtime_model`が
> `Realtime models are not available for this workspace.`というエラーで拒否されます。

## 音声モードの選択

次のいずれかに該当する場合は、エージェントをカスタムモードのままにしてください。

* エージェントが[カスタムLLM](/docs/ja/eleven-agents/customization/llm/custom-llm)、Amazon Bedrock、または[スピーチエンジン](/docs/ja/eleven-api/guides/cookbooks/speech-engine)を使用している。
* エージェントに特定のLLMまたはTTSモデルが必要である。
* ワークフローノードがLLM、TTSモデル、または別の[管理対象設定](#managed-settings)を上書きしている。
* エージェントがカスタムモードのエージェントへ、またはそこから転送する。
* エージェントがテキストのみである。リアルタイムモデルは音声会話向けに構築されています。

それ以外の場合は、まずEleven Realtime v1 Miniを使用してください。次の場合は、代わりにEleven Realtime v1 Maxを選択します。

* エージェントが長いまたは複雑な指示に従う、あるいは複数ステップのツール呼び出しに依存しており、Miniの応答では十分でない。
* エージェントが米国またはEUで[ゼロ保持モード](/docs/ja/eleven-agents/customization/privacy/zrm)または[HIPAA](/docs/ja/eleven-agents/legal/hipaa)に準拠する必要がある。Miniはいずれの場合も利用できません。

Maxはインドおよびシンガポールのデータレジデンシー環境では利用できず、トークン上限を1,024以上にするか、上限なしにする必要があります。[制限事項](#limitations)と[コンプライアンスとデータレジデンシー](#compliance-and-data-residency)を参照してください。

## 設定

#### ダッシュボードで更新

#### Agentタブを開く

ダッシュボードでエージェントを開き、**Agent**タブに移動します。

#### 音声モードを設定

**音声モード**を**リアルタイム**に設定します。エージェントはEleven Realtime v1 Miniに切り替わります。

#### モデルを選択

Eleven Realtime v1 Maxを使用するには、**モデル**リストから選択します。

#### 公開

変更を公開します。エージェントが[制限事項](#limitations)のいずれかのルールに違反している場合、公開は失敗します。

リアルタイムをオフにするには、**音声モード**を**カスタム**に設定して公開します。エージェントは保存されているLLM、TTSモデル、ASR設定に戻ります。

#### CLIで更新

#### エージェント設定を取得

```bash
elevenlabs agents pull --agent "<agent-name>"
```

#### \`agent_configs/\<agent-name>.json\`を編集

`conversation_config.realtime_model`を設定します。

```json
{
  "conversation_config": {
    "realtime_model": "eleven_realtime_v1_mini"
  }
}
```

リアルタイムをオフにするには、`realtime_model`を`null`に設定します。

#### 変更をプッシュ

```bash
elevenlabs agents push --agent "<agent-name>"
```

#### APIで更新

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "realtime_model": "eleven_realtime_v1_mini",
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    realtimeModel: "eleven_realtime_v1_mini",
  },
});
```

リアルタイムをオフにするには、Pythonでは`realtime_model`を`None`に、TypeScriptでは`realtimeModel`を`null`に設定します。

## 管理対象設定

リアルタイムモデルが設定されている間、ElevenLabsは以下の設定を管理し、エージェントはそれらに保存されている値を無視します。カスタムに切り替えると、保存されている値が再び使用されます。

| 設定          | `conversation_config`内のフィールド              |
| ----------- | ----------------------------------------- |
| LLM         | `agent.prompt.llm`                        |
| 推論の強度       | `agent.prompt.reasoning_effort`           |
| 思考予算        | `agent.prompt.thinking_budget`            |
| 並列ツール呼び出し   | `agent.prompt.enable_parallel_tool_calls` |
| カスケードタイムアウト | `agent.prompt.cascade_timeout_seconds`    |
| TTSモデル      | `tts.model_id`                            |
| 表現力モード      | `tts.expressive_mode`                     |
| ASRプロバイダー   | `asr.provider`                            |

トークン上限（`agent.prompt.max_tokens`）は保存されている値を維持しますが、ワークフローノードでは上書きできず、Eleven Realtime v1 Maxには最小値が必要です。[制限事項](#limitations)を参照してください。

これらの設定を変更するには、エージェントをカスタムに切り替えてください。

## 引き続き適用される設定

以下を含む、その他のすべてのエージェント設定はカスタムモードと同様に機能します。

* システムプロンプトと最初のメッセージ
* [マルチ音声サポート](/docs/ja/eleven-agents/customization/voice/multi-voice-support)を含む音声
* [言語](/docs/ja/eleven-agents/customization/voice/customization/language)
* 温度
* [ツール](/docs/ja/eleven-agents/customization/tools)と[ナレッジベース](/docs/ja/eleven-agents/customization/knowledge-base)
* ターンの積極性、タイムアウト、中断などの[会話フロー](/docs/ja/eleven-agents/customization/conversation-flow)設定

エージェントがリアルタイムモードの間、ダッシュボードでは温度を含むLLM設定は非表示になります。リアルタイムエージェントの温度を変更するには、CLIまたはAPIを使用してください。

リアルタイムモデルが時間内に応答しない、またはエラーを返した場合、エージェントは[LLMカスケーディング](/docs/ja/eleven-agents/customization/llm/llm-cascading)で説明されているようにバックアップLLMにフォールバックします。リアルタイムモデルは、フォールバックまでにエージェントが待機する時間を設定します。

## 制限事項

ElevenLabsは、エージェントを公開するときにこれらのルールを確認します。いずれかに違反する下書きも保存できますが、公開は変更が必要な設定を示すエラーで失敗します。

* **ElevenAgentsエージェントのみ**： [スピーチエンジン](/docs/ja/eleven-api/guides/cookbooks/speech-engine)など、他のElevenLabsプロダクトで作成されたエージェントでは、リアルタイムモデルを使用できません。
* **カスタムLLM不可**：エージェントのLLMがカスタムLLMまたはAmazon Bedrockである間は、リアルタイムモードを利用できません。切り替える前に、カスタムモードで組み込みLLMを選択してください。
* **管理対象設定のワークフロー上書き不可**：ワークフローノードでは、[管理対象設定](#managed-settings)またはトークン上限を上書きできません。上書きを削除するか、エージェントをカスタムモードのままにしてください。
* **Maxのトークン上限**：Eleven Realtime v1 Maxには、1,024以上のトークン上限、または上限なしが必要です。
* **モード間の転送**：リアルタイムモードのエージェントは、他のリアルタイムモードのエージェントに対してのみ[転送](/docs/ja/eleven-agents/customization/tools/system-tools/agent-transfer)できます。MiniとMaxのエージェント間の転送はサポートされています。

> **Warning**
>
> 公開時の確認では、公開されたエージェントが実行する転送のみが対象です。カスタムモードのエージェントからリアルタイムエージェントへの転送は、
> カスタムモードのエージェントが次に公開されたときにのみ検出されます。それまでは、
> 会話中に転送が拒否され、現在のエージェントが通話に残ります。

転送エラーは`Transfers between default and Realtime model modes are not supported.`と表示されます。ここでの「default」はカスタムモードを意味します。

## コンプライアンスとデータレジデンシー

リアルタイムモデルには、他のモデルと同じ[ゼロ保持モード](/docs/ja/eleven-agents/customization/privacy/zrm)、[HIPAA](/docs/ja/eleven-agents/legal/hipaa)、[データレジデンシー](/docs/ja/overview/administration/data-residency)のルールが適用されます。利用可否はMiniとMaxで異なります。

| 環境               | Eleven Realtime v1 Mini | Eleven Realtime v1 Max |
| ---------------- | ----------------------- | ---------------------- |
| 米国               | 利用可能                    | 利用可能                   |
| EUデータレジデンシー      | 利用可能                    | 利用可能                   |
| インドのデータレジデンシー    | 利用可能                    | 利用不可                   |
| シンガポールのデータレジデンシー | 利用可能                    | 利用不可                   |
| ゼロ保持モードとHIPAA    | 利用不可                    | 米国およびEUで利用可能           |

ゼロ保持モードは、ワークスペースで強制されている場合も、エージェントで有効になっている場合も適用されます。

エージェントのコンプライアンスまたはデータレジデンシー設定でリアルタイムモデルが利用できない場合、ElevenLabsはモデル名を示すエラーで拒否します。もう一方のリアルタイムモデルを選択するか、カスタムに切り替えてください。

## 料金

リアルタイムエージェントには、標準のElevenAgents分単位料金に加え、リアルタイムモデルの料金に基づく入力、キャッシュ済み入力、出力トークンの料金がかかります。Eleven Realtime v1 Maxは、Eleven Realtime v1 Miniよりトークンあたりの料金が高くなります。現在の料金については[ElevenLabs料金](https://elevenlabs.io/pricing)を参照してください。

## 関連リソース

* [モデル](/docs/ja/eleven-agents/customization/llm)
* [LLMカスケーディング](/docs/ja/eleven-agents/customization/llm/llm-cascading)
* [エージェント転送](/docs/ja/eleven-agents/customization/tools/system-tools/agent-transfer)
* [ゼロ保持モード](/docs/ja/eleven-agents/customization/privacy/zrm)
* [HIPAAコンプライアンス](/docs/ja/eleven-agents/legal/hipaa)