docs

Voices & languages

A curated voice library across 80 languages, plus your own clones.

The voice roster

The voice library is curated and growing, spanning ages, timbres, and languages. Fetch the roster at runtime rather than hardcoding a list; store each voice’s voice_id and display its name.

GET/v1/voices
{
  "voices": [
    {
      "voice_id": "3b5275e4f2",
      "name": "Tara",
      "category": "premade",
      "description": "The first voice Svara learned to love. Warm Hindi storytelling with a patient, late-evening calm.",
      "labels": { "language": "hi", "use_case": "narrative_story" },
      "preview_url": "/v1/voices/3b5275e4f2/preview"
    },
    ...
  ]
}
  • voice_id is a short 10-character hex code; it is the only way to address a voice in a TTS call, on either dialect
  • library voices are category: premade; your clones are cloned
  • to clone your own: POST /v1/audio/encode with a 5 to 20 second clip, then generate with mode: voice_clone and the returned reference_codes. See Voice cloning.
Browsing rather than integrating? The console Voices page lets you audition every voice and filter by language and gender.

Voice previews

Every voice has a bundled preview clip; use it instead of live-synthesizing sample audio (it’s instant and free):

GET/v1/voices/{voice_id}/preview

The preview_url is included in each voice object from /v1/voices, so you rarely construct this URL by hand.

Languages

The model handles 80 languages and code-switches between them within a single request. Drive language pickers from the languages endpoint:

GET/v1/languages

When calling TTS, the lang hint accepts any ISO form: hi, hin, hindi, hi-IN all resolve. Sending it enables number and unit normalization; omit it to auto-detect from the script. See Text to speech for details.