Skip to main content
Integrate your own ElevenLabs API keys and voice configurations with LiveAvatar FULL Mode sessions.

​
When to use this

  • You have existing ElevenLabs voice configurations you want to use
  • You need enhanced control over voice selection and settings

​
Setup

​
Step 1: Register your ElevenLabs API key

curl -X POST https://api.liveavatar.com/v1/secrets \
  -H "X-API-KEY: <YOUR_API_KEY>" \
  -H "content-type: application/json" \
  -d '{
    "secret_type": "ELEVENLABS_API_KEY",
    "secret_value": "<your_elevenlabs_api_key>",
    "secret_name": "My ElevenLabs Key"
  }'
Returns a secret_id.

​
Step 2: Import your voice

Create a voice configuration using your ElevenLabs voice ID and stored secret: 
curl -X POST https://api.liveavatar.com/v1/voices/third_party \
  -H "X-API-KEY: <YOUR_API_KEY>" \
  -H "content-type: application/json" \
  -d '{
    "secret_id": "<secret_id>",
    "voice_id": "<elevenlabs_voice_id>"
  }'
You can find your ElevenLabs voice IDs through the ElevenLabs dashboard or their API. The imported voice will appear in your LiveAvatar voice listing.

​
Step 3: Start a session with your voice

Use the voice_id from the import when creating your session token: 
{
  "mode": "FULL",
  "avatar_id": "<avatar_id>",
  "avatar_persona": {
    "voice_id": "<your_imported_voice_id>",
    "context_id": "<context_id>"
  }
}
LiveAvatar uses your ElevenLabs credentials for audio generation during the session.
The voice becomes invalid if the underlying ElevenLabs voice is deleted or the associated secret is removed.