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

# Voices and Languages

> How Plivo Text-to-Speech voices map to languages, and how to pick a voice for your use case.

> [!NOTE]
>
> Each Plivo voice speaks one language. List voices with the Voices API, then pick one whose `languages` match your text.

## How voices work

* Every voice has a `voice_id`, `name`, `gender`, `languages`, `accent_type`, `description` and a `sample_url` you can play.
* Each voice speaks **one** language. Sending text in another language returns `400 language_not_supported`.
* The list has Plivo's public voices and any voices your organization owns.

## Voice catalog

33 voices across 11 languages. This list comes from the [List voices API](https://plivo.com/docs/models/text-to-speech/api/voices.md); call it for the current list, including your organization's own voices.

| Language | Voices | Female | Male |
| - | - | - | - |
| English (US) (`en-US`) | 5 | 2 | 3 |
| English (UK) (`en-GB`) | 3 | 2 | 1 |
| English (India) (`en-IN`) | 4 | 2 | 2 |
| English (Australia) (`en-AU`) | 1 | 1 | 0 |
| Hindi (`hi`) | 4 | 2 | 2 |
| Bengali (`bn`) | 3 | 2 | 1 |
| Tamil (`ta`) | 2 | 1 | 1 |
| Telugu (`te`) | 2 | 0 | 2 |
| Marathi (`mr`) | 4 | 2 | 2 |
| Gujarati (`gu`) | 2 | 0 | 2 |
| Kannada (`kn`) | 3 | 2 | 1 |

> [tab] English
>
> | Name | `voice_id` | Gender | Language |
> | - | - | - | - |
> | Allison | `GhXTeeZNT1zacg9RUbXa` | Female | `en-US` |
> | Hailey | `lC7qzMoRE7SSjaNCVeff` | Female | `en-US` |
> | Garrett | `P2WNP5RVUP1t6dK9PY52` | Male | `en-US` |
> | Terrell | `ieA6hQ563LgXTiOgy6kz` | Male | `en-US` |
> | Travis | `Ak70ycoSdDYbeq5sAXsc` | Male | `en-US` |
> | Eleanor | `Ic0DJ4TLN1ELIYmzwi6H` | Female | `en-GB` |
> | Poppy | `0isEP1KMeZPsGSP5qj2A` | Female | `en-GB` |
> | Archie | `zYmyWxqLSdlQ0MA4AQEV` | Male | `en-GB` |
> | Nisha | `H25SvwivznBqsIx1R7hX` | Female | `en-IN` |
> | Prerna | `3gVUACYdS3ibtu8qPruB` | Female | `en-IN` |
> | Aarav | `vGOW5Fzss7kzS9IxCObo` | Male | `en-IN` |
> | Karan | `34AUgJTl9p1TLO99Mc7E` | Male | `en-IN` |
> | Tahlia | `S4OkXYkfzKK9f6wzmQ0X` | Female | `en-AU` |

> [tab] Hindi
>
> | Name | `voice_id` | Gender |
> | - | - | - |
> | Meera | `6uWzc4xFj31t4jNJUaED` | Female |
> | Ritika | `Hiqcy02wuf8a4sCMcdNO` | Female |
> | Aman | `OmziUEKO4d83QuGMo3bP` | Male |
> | Ishaan | `nzWUWk5ShuIYGSosxESk` | Male |

> [tab] Bengali
>
> | Name | `voice_id` | Gender |
> | - | - | - |
> | Debasmita | `cZncSKHriH32h4IKwAF1` | Female |
> | Ishani | `GKrPm1RIxbJRv4yYqAxX` | Female |
> | Subhankar | `vxMrWeHTjRflUziEla6E` | Male |

> [tab] Tamil
>
> | Name | `voice_id` | Gender |
> | - | - | - |
> | Nandhini | `wDPugzmr5HSlFv9MaXk0` | Female |
> | Kathir | `4YwYWODqig98puWmLYRz` | Male |

> [tab] Telugu
>
> | Name | `voice_id` | Gender |
> | - | - | - |
> | Abhiram | `v2jq1LG20JPbAVrlTWmZ` | Male |
> | Pavan | `cXEjlQTYG6DCOlWVjGe9` | Male |

> [tab] Marathi
>
> | Name | `voice_id` | Gender |
> | - | - | - |
> | Sanika | `KCWPtNGDMOQ5bI9SiaIm` | Female |
> | Shravani | `WqKlYdzJonf6PWElzV6a` | Female |
> | Akshay | `KYAauPOeeH6Xkcy9YBA7` | Male |
> | Mandar | `nBMKcKglpeBGawQWLrOa` | Male |

> [tab] Gujarati
>
> | Name | `voice_id` | Gender |
> | - | - | - |
> | Hiren | `xHCIssLpg7mFHuxJAl5D` | Male |
> | Nirav | `9ZCJ1Lca7nXQprCrubMG` | Male |

> [tab] Kannada
>
> | Name | `voice_id` | Gender |
> | - | - | - |
> | Bhavana | `iNhbJlZPe4LFctxRtJPD` | Female |
> | Spoorthi | `Ba1rbMwhlf3aXyxKB99Q` | Female |
> | Pradeep | `JlZpUKXSnAs3C1qmfJR8` | Male |

English is four languages, one per accent: `en-US`, `en-GB`, `en-IN` and `en-AU`. A voice speaks only its own accent's code.

## The `language` parameter

`language` defaults to `auto`, which detects the language of the text. Set it explicitly when you know it. Use one of `auto`, `en-US`, `en-GB`, `en-IN`, `en-AU`, `hi`, `bn`, `ta`, `te`, `mr`, `gu` or `kn`. There is no plain `en`: it returns `422 invalid_request`.

## Related

* [List voices API](https://plivo.com/docs/models/text-to-speech/api/voices.md)
