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

# Voice Lab

> Browse, audition, and swap realistic AI voices across providers like Cartesia and ElevenLabs for your agent

**Voice Lab** is your studio for discovering, auditioning, and customizing AI voices. If the default voice on your agent doesn't fit your brand persona, Voice Lab allows you to browse hundreds of voices across industry-leading Text-to-Speech (TTS) providers, filter by gender, accent, and style, listen to audio samples, and swap voices onto your agents with a single click.

## Video Walkthrough

[https://www.loom.com/embed/9181faa22b7844618272949c2135339a](https://www.loom.com/embed/9181faa22b7844618272949c2135339a)

## Why Use Voice Lab?

* **Multi-Provider Voice Catalog**: Access state-of-the-art voices from Cartesia, ElevenLabs, and other specialized neural voice engines without juggling separate provider accounts.
* **Granular Filters**: Filter by provider, language, regional accent (e.g. US, UK, Indian English, Spanish), gender, and speaking character.
* **Instant Audio Previews**: Audition realistic speech samples before committing a voice to production calls.
* **One-Click Agent Swapping**: Directly assign chosen voices to your agent's persona settings.

***

## How to Select and Swap Voices

**1. Navigate to Voice Lab**

In the dashboard sidebar, click **Voice Lab** (or **Voices**).

**2. Filter by Provider and Characteristics**

Use the filter controls at the top of the catalog:

* **Provider**: Select your preferred provider (e.g., **Cartesia** for ultra-low latency conversational speed, or **ElevenLabs** for deep narrative expressiveness).
* **Language & Accent**: Choose your target language and regional accent (e.g., `English (US)` or `English (India)`).
* **Gender**: Select `Male`, `Female`, or `Neutral`.

**3. Audition Voice Previews**

Click the **Play** button on any voice card to listen to sample audio. Compare different voices (e.g. *"Adam Jones"*, *"Sarah"*, *"Marcus"*) to find the exact tone and pacing that fits your company's persona.

**4. Note or Select the Voice**

Once you find the ideal voice, note its name and provider (or click **Use in Agent** / copy the Voice ID).

**5. Assign the Voice to Your Agent**

Go to **Agent Config** → select your agent → navigate to the **Persona** tab:

* Under **Senses & Capabilities → Mouth (TTS)**, set the **TTS Provider** to match your chosen voice (e.g. **Cartesia**).
* In the voice selector dropdown, choose your voice (e.g. `Adam Jones`) or enter the voice ID.
* Click **Save**.

> [!TIP]
>
> Edits take effect immediately. All subsequent calls dialed by this agent will now use your newly selected Voice Lab voice.

***

## Troubleshooting

> **The audio preview isn't playing in Voice Lab**
>
> Ensure your browser has permission to play audio. Check that your audio output device is properly connected and that no ad-blockers are intercepting audio streaming endpoints.

> **The voice sounds slightly different during real telephone calls**
>
> Telephone networks transmit audio over narrow-band or wide-band codecs (such as G.711 or Opus). High-fidelity audio played through your desktop browser may sound slightly warmer than standard cellular telephone lines. Test the agent with a real test call to your mobile number to evaluate actual telephony audio quality.

> **Can I use a custom cloned voice?**
>
> Yes! Vaani supports custom voice cloning. In Voice Lab, you can upload a clean 1–2 minute audio sample of a speaker to generate a private cloned voice model that only your organization can access.

> **What happens if a voice provider experiences an outage?**
>
> In your agent's **Persona → Mouth** settings, you can configure a **Fallback TTS Provider**. If your primary engine (such as Cartesia) experiences a temporary network hiccup, Vaani will automatically failover to your secondary engine so your calls continue uninterrupted.

***

## Next Step

> **[Configure Agent Experience](https://docs.vaanivoice.ai/getting-started/configure-experience)**
>
> Fine-tune conversational flow, background noise, filler words, and idle controls


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.