> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sambanova.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ElevenLabs

本ガイドでは、[ElevenLabs](https://elevenlabs.io/) と SambaCloud の高速 LLM 推論エンジンを組み合わせて、低レイテンシな対話型 AI エージェントを構築する方法を解説します。円滑な音声対話の実現には低レイテンシが不可欠です。SambaNova の専用ハードウェアは、リアルタイム音声に求められる推論速度を実現します。

## 前提条件

* [SambaCloud](https://cloud.sambanova.ai/?utm_source=elevenlabs\&utm_medium=external\&utm_campaign=cloud_signup) アカウントと [API キー](https://cloud.sambanova.ai/apis?utm_source=elevenlabs\&utm_medium=external\&utm_campaign=cloud_signup)
* [ElevenLabs](https://elevenlabs.io/app/sign-in) アカウント
* SambaCloud のモデル ID (例: `DeepSeek-V3.1` や `Meta-Llama-3.3-70B-Instruct`)。全モデルの一覧は [SambaCloud モデル](/docs/ja/models/sambacloud-models) をご参照ください。

## セットアップ

<Steps>
  <Step title="ElevenLabs で新しいエージェントを作成">
    [ElevenLabs](https://elevenlabs.io/app/agents) にログインし、**Agents** を開いて **+ New agent** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/sambanova-systems/2pjT84k6CL8mzKsf/images/docs/integrations/elevenlabs/elevenlabs_create_agent.png?fit=max&auto=format&n=2pjT84k6CL8mzKsf&q=85&s=6a985be38fd0dcb03123fffbe26df7c5" alt="New agent ボタンが表示された ElevenLabs の Agents ページ" className="dark:hidden" width="3002" height="1160" data-path="images/docs/integrations/elevenlabs/elevenlabs_create_agent.png" />

      <img src="https://mintcdn.com/sambanova-systems/2pjT84k6CL8mzKsf/images/docs/integrations/elevenlabs/elevenlabs_create_agent_dark.png?fit=max&auto=format&n=2pjT84k6CL8mzKsf&q=85&s=116ea1faebbf1c18dc84052c59f416e9" alt="New agent ボタンが表示された ElevenLabs の Agents ページ" className="hidden dark:block" width="3014" height="1260" data-path="images/docs/integrations/elevenlabs/elevenlabs_create_agent_dark.png" />
    </Frame>
  </Step>

  <Step title="LLM を Custom に設定">
    エージェントの **LLM** セクションを開き、設定を **Custom** に切り替えます。

    <Frame>
      <img src="https://mintcdn.com/sambanova-systems/2pjT84k6CL8mzKsf/images/docs/integrations/elevenlabs/elevenlabs_custom_LLM.png?fit=max&auto=format&n=2pjT84k6CL8mzKsf&q=85&s=80d652e090bd40fa1b50b1a05e508738" alt="ElevenLabs の Custom LLM 設定" className="dark:hidden" width="976" height="1006" data-path="images/docs/integrations/elevenlabs/elevenlabs_custom_LLM.png" />

      <img src="https://mintcdn.com/sambanova-systems/2pjT84k6CL8mzKsf/images/docs/integrations/elevenlabs/elevenlabs_custom_LLM_dark.png?fit=max&auto=format&n=2pjT84k6CL8mzKsf&q=85&s=59b3cea5249f601c3ee753954ac8cc47" alt="ElevenLabs の Custom LLM 設定" className="hidden dark:block" width="988" height="1040" data-path="images/docs/integrations/elevenlabs/elevenlabs_custom_LLM_dark.png" />
    </Frame>
  </Step>

  <Step title="エージェントの接続先を SambaCloud に設定">
    Custom LLM パネルで、SambaNova の情報を入力します。

    * **Server URL**: **Chat Completions** を選択し、`https://api.sambanova.ai/v1/` を入力します (`/chat/completions` は ElevenLabs が自動的に付加します)。
    * **Model ID**: [SambaCloud のモデル](/docs/ja/models/sambacloud-models) (例: `DeepSeek-V3.1`) を入力します。
    * **API Key**: **Secret** を選択し、[SambaCloud API キー](https://cloud.sambanova.ai/apis?utm_source=elevenlabs\&utm_medium=external\&utm_campaign=cloud_signup) をワークスペースシークレットとして追加してドロップダウンから選択します。
    * **Max tokens** (任意): **Limit token usage** セクションで最大トークン数を `1024` に設定すると、会話に適した応答長になります。

    **Connection successful** の確認表示を待ってから、**Save** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/sambanova-systems/2pjT84k6CL8mzKsf/images/docs/integrations/elevenlabs/elevenlabs_LLM_Config.png?fit=max&auto=format&n=2pjT84k6CL8mzKsf&q=85&s=bfa53acf009f76cd10d09738c81e5eea" alt="SambaCloud の情報を入力した ElevenLabs の Custom LLM 設定" className="dark:hidden" width="988" height="1298" data-path="images/docs/integrations/elevenlabs/elevenlabs_LLM_Config.png" />

      <img src="https://mintcdn.com/sambanova-systems/2pjT84k6CL8mzKsf/images/docs/integrations/elevenlabs/elevenlabs_LLM_Config_dark.png?fit=max&auto=format&n=2pjT84k6CL8mzKsf&q=85&s=71eb921223ec103238f6da0a463b7f4d" alt="SambaCloud の情報を入力した ElevenLabs の Custom LLM 設定" className="hidden dark:block" width="998" height="1338" data-path="images/docs/integrations/elevenlabs/elevenlabs_LLM_Config_dark.png" />
    </Frame>
  </Step>

  <Step title="エージェントのプレビューと会話テスト">
    **Test AI agent → Call AI agent** をクリックしてライブプレビューを起動します。エージェントに話しかけ、リアルタイムに応答することを確認します。

    <Frame>
      <img src="https://mintcdn.com/sambanova-systems/2pjT84k6CL8mzKsf/images/docs/integrations/elevenlabs/elevenlabs_preview_agent.png?fit=max&auto=format&n=2pjT84k6CL8mzKsf&q=85&s=5ec84d7b72f37146afab03b03b85f9ed" alt="ElevenLabs のエージェントプレビューパネル" className="dark:hidden" width="2974" height="1694" data-path="images/docs/integrations/elevenlabs/elevenlabs_preview_agent.png" />

      <img src="https://mintcdn.com/sambanova-systems/2pjT84k6CL8mzKsf/images/docs/integrations/elevenlabs/elevenlabs_preview_agent_dark.png?fit=max&auto=format&n=2pjT84k6CL8mzKsf&q=85&s=ed956e6e3e12ab7fb25ae16afb1ab1f8" alt="ElevenLabs のエージェントプレビューパネル" className="hidden dark:block" width="2994" height="1650" data-path="images/docs/integrations/elevenlabs/elevenlabs_preview_agent_dark.png" />
    </Frame>
  </Step>

  <Step title="SambaCloud 経由での呼び出しの確認">
    エージェントが SambaNova にリクエストを送信していることを確認するには、以下の手順を実行します。

    1. [SambaCloud Console](https://cloud.sambanova.ai/) を開き、**Usage** (または **Dashboard → Usage**) に移動します。
    2. ElevenLabs に追加した **API キー**で絞り込み、時間範囲を直近 1 時間に設定します。
    3. 現在の **Requests** 数を控えておきます。
    4. ElevenLabs で 1〜2 ターンのテスト通話を実行します。
    5. **Usage** ページを更新します。カウンターがモデルのターン数分だけ増加するはずです。

    カウンターが増えない場合は、Server URL の末尾のスラッシュ、シークレット名、API キーが有効であることを再確認してください。
  </Step>
</Steps>

## トラブルシューティング

<AccordionGroup>
  <Accordion title="接続に失敗する、または API キーエラーが発生する">
    * [SambaCloud ポータル](https://cloud.sambanova.ai/apis?utm_source=elevenlabs\&utm_medium=external\&utm_campaign=cloud_signup) で、SambaCloud API キーが正しく有効であることを確認します
    * Server URL が `https://api.sambanova.ai/v1/` であることを確認します (末尾のスラッシュが必須です)
    * ElevenLabs でシークレットを再入力し、**Save** をクリックします
  </Accordion>

  <Accordion title="モデルが応答しない、またはモデル ID が無効">
    * モデル ID が [SambaCloud モデルページ](/docs/ja/models/sambacloud-models) にある有効なモデルと一致していることを確認します
    * SambaCloud アカウントが有効であることを確認します
  </Accordion>

  <Accordion title="Usage のカウンターが増加しない">
    * ElevenLabs で正しい API キーが選択されていることを確認します
    * 1〜2 分待ってから Usage ページを更新します
    * ElevenLabs のエージェントログにエラーがないか確認します
  </Accordion>
</AccordionGroup>