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

<div style="position: relative; padding-bottom: 62.7906976744186%; height: 0;">
  <iframe src="https://www.loom.com/embed/9181faa22b7844618272949c2135339a" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;" />
</div>

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

<Steps>
  <Step title="Navigate to Voice Lab">
    In the dashboard sidebar, click **Voice Lab** (or **Voices**).
  </Step>

  <Step title="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`.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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).
  </Step>

  <Step title="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**.
  </Step>
</Steps>

<Tip>
  Edits take effect immediately. All subsequent calls dialed by this agent will now use your newly selected Voice Lab voice.
</Tip>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

***

## Next Step

<Card title="Configure Agent Experience" icon="sliders" href="/getting-started/configure-experience">
  Fine-tune conversational flow, background noise, filler words, and idle controls
</Card>


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