# ElevenLabs API Integration

{% hint style="danger" %}
**Currently, only ElevenLabs accounts with their associated Pro plans and higher are compatible due to the 44.1kHz audio output.** \
\
**All tiers of Convai accounts can add an ElevenLabs API key integration.**
{% endhint %}

{% hint style="info" %}
**Note : If you are receiving token errors while speaking with your characters,  please confirm your ElevenLabs subscription is valid and you have a remaining token quota on your** [**ElevenLabs.io**](https://elevenlabs.io/) **dashboard.**
{% endhint %}

Step 1.  Go to [elevenlabs.io](https://elevenlabs.io/) and head to your Profile section

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FqP4pkNax88Q17q2xZDXw%2FUntitled%20design%20(5).png?alt=media&#x26;token=4fc06398-b6a2-41af-82eb-05f2af2708a5" alt=""><figcaption></figcaption></figure>

Step 2. On the Profile section, create an API key with the following permissions :

`Text to Speech`  : `Access`&#x20;

<figure><img src="https://413558230-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&#x26;token=83f20937-6b52-4f60-bc4a-2a9867411cdf" alt=""><figcaption></figcaption></figure>

`Voices` : `Read`&#x20;

<figure><img src="https://413558230-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&#x26;token=8099e90b-e1b2-4487-b0ef-75f4b70aae67" alt=""><figcaption></figcaption></figure>

`User` : `Read`&#x20;

<figure><img src="https://413558230-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&#x26;token=346a1c8c-8996-44a9-a07a-aff74349c2c6" alt=""><figcaption></figcaption></figure>

And copy the API key for the next step.

Step 3. Next, login to convai.com and open your Profile page

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

Step 4. On the bottom right corner "API Integration" click on "Add New Key" button

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

Step 5. A pop up will appear then, select ElevenLabs, then paste your API key and click Add.

{% hint style="danger" %}
**It will take some time (\~12 hrs) for your voices be visible in Convai dashboard.** \
**You can accelerate the process for viewing newly added voices by removing and adding your ElevenLabs API key again.**
{% 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>

Step 6. Go to any character and under their Character Description, select Character's Voice, scroll to the bottom and you will see a  new section "Elevenlabs-Private-Voices" and all of your voices will be visible there. Select as desired and utilize.

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