> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/other-integrations/third-party-api-integrations/elevenlabs-api-integration.md).

# ElevenLabs API 集成

这是一份关于如何将你的 ElevenLabs 声音与 Convai 角色集成的指南

{% hint style="danger" %}
**目前，由于 44.1kHz 音频输出，只有拥有对应 Pro 及更高级别套餐的 ElevenLabs 账户兼容。**\
\
**所有等级的 Convai 账户都可以添加 ElevenLabs API 密钥集成。**
{% endhint %}

{% hint style="info" %}
**注意：如果你在与角色对话时收到 token 错误，请确认你的 ElevenLabs 订阅仍然有效，并且你的** [**ElevenLabs.io**](https://elevenlabs.io/) **控制面板。**
{% endhint %}

步骤 1. 前往 [elevenlabs.io](https://elevenlabs.io/) 并进入你的个人资料部分

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FJdLY4BmPdvtZLP8KypDV%2FUntitled%20design%20(5).png?alt=media&amp;token=48114d79-a869-4b7a-b442-dd2b873d60d4" alt=""><figcaption></figcaption></figure>

步骤 2. 在个人资料部分，使用以下权限创建一个 API 密钥：

`文本转语音` : `访问权限`

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FRewYvX7e8yOf82635CaA%2FScreenshot%202025-08-27%20at%205.54.40%E2%80%AFPM.png?alt=media&amp;token=83f20937-6b52-4f60-bc4a-2a9867411cdf" alt=""><figcaption></figcaption></figure>

`语音` : `读取`

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FDUiA3eccUdqEbYPW9ESa%2FScreenshot%202025-08-27%20at%205.54.57%E2%80%AFPM.png?alt=media&amp;token=8099e90b-e1b2-4487-b0ef-75f4b70aae67" alt=""><figcaption></figcaption></figure>

`用户` : `读取`

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FVS3WKWUzRu3rzXOturlV%2FScreenshot%202025-08-27%20at%205.55.11%E2%80%AFPM.png?alt=media&amp;token=346a1c8c-8996-44a9-a07a-aff74349c2c6" alt=""><figcaption></figcaption></figure>

然后复制该 API 密钥，进入下一步。

步骤 3. 接下来，登录 convai.com 并打开你的个人资料页面

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtvHXv9Cpl8QzA5tY9MJh%2Fuploads%2FAJxT96IvZIPOhEMg3M5G%2FScreenshot%202024-02-06%20at%206.45.04%E2%80%AFPM.png?alt=media&#x26;token=9103ac42-6597-48d8-8e0f-c429acfaaa49" alt=""><figcaption></figcaption></figure>

步骤 4. 在右下角的“API 集成”中，点击“添加新密钥”按钮

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FlaOPnoRsWt60bzCYQOlW%2FUntitled%20design%20(2).png?alt=media&amp;token=e2938ea2-4c08-478a-893a-ba5885eb6a3b" alt=""><figcaption></figcaption></figure>

步骤 5. 此时会弹出一个窗口，选择 ElevenLabs，然后粘贴你的 API 密钥并点击添加。

{% hint style="danger" %}
**你的语音在 Convai 控制面板中显示出来需要一些时间（约 12 小时）。**\
**你可以通过删除并重新添加你的 ElevenLabs API 密钥来加快查看新添加语音的过程。**
{% endhint %}

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtvHXv9Cpl8QzA5tY9MJh%2Fuploads%2Fs8EbPIU1l9PpKRJNuseC%2FScreenshot%202024-02-06%20at%206.48.43%E2%80%AFPM.png?alt=media&#x26;token=774991bb-c41a-4743-afed-6e0094850c81" alt=""><figcaption></figcaption></figure>

步骤 6. 进入任意角色，在其角色描述下选择角色语音，向下滚动到底部，你会看到一个新的部分“Elevenlabs-Private-Voices”，你的所有语音都会显示在那里。按需选择并使用。

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtvHXv9Cpl8QzA5tY9MJh%2Fuploads%2FS9INCC48hKOpkP85fLXI%2FScreenshot%202024-02-06%20at%207.04.09%E2%80%AFPM.png?alt=media&#x26;token=f0168791-2e67-49fe-bc8b-21eee468870b" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/other-integrations/third-party-api-integrations/elevenlabs-api-integration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.