Custom TTS Integration

Integrate your own third-party TTS API keys and voice configurations with LiveAvatar FULL Mode sessions. Three providers are supported:

Provider	`secret_type`
ElevenLabs	`ELEVENLABS_API_KEY`
Fish Audio	`FISH_API_KEY`
Cartesia	`CARTESIA_API_KEY`

Custom ElevenLabs TTS is not available on ElevenLabs free-tier API keys. ElevenLabs blocks third-party usage on free plans. You must have a paid ElevenLabs subscription to use ElevenLabs voices.

When to use this

You have existing voice configurations with one of these providers
You need enhanced control over voice selection and settings

Setup

Step 1: Register your provider API key

Store the API key for your provider. Set secret_type to the value for that provider from the table above.

curl -X POST https://api.liveavatar.com/v1/secrets \
  -H "X-API-KEY: <YOUR_API_KEY>" \
  -H "content-type: application/json" \
  -d '{
    "secret_type": "CARTESIA_API_KEY",
    "secret_value": "<your_provider_api_key>",
    "secret_name": "My Cartesia Key"
  }'

Returns a secret_id.

Step 2: Import your voice

Bind a provider voice to your stored secret. provider_voice_id is the voice ID from the provider; name is optional.

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>",
    "provider_voice_id": "<provider_voice_id>",
    "name": "My Custom Voice"
  }'

Find your voice IDs through the provider’s dashboard or 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 provider credentials for audio generation during the session.

The voice becomes invalid if the underlying provider voice is deleted or the associated secret is removed.

Getting Started

Core Concepts

FULL Mode

Avatar Only (LITE mode)

Socials

FAQ

When to use this

Setup

Step 1: Register your provider API key

Step 2: Import your voice

Step 3: Start a session with your voice

​When to use this

​Setup

​Step 1: Register your provider API key

​Step 2: Import your voice

​Step 3: Start a session with your voice

When to use this

Setup

Step 1: Register your provider API key

Step 2: Import your voice

Step 3: Start a session with your voice