Skip to navigation

Change the speaker voice

View as Markdown

The speaker parameter selects the voice for the generated speech. Speaker names are lowercase and case-sensitive (shubh, not Shubh).

ParameterTypeDefaultModelsAPIs
speakerstringshubh_enhi_ads on bulbul:v4-flash, shubh on bulbul:v3bulbul:v4-flash, bulbul:v3REST, HTTP stream, WebSocket

Hear the voices before you choose: the Voices page has audio samples for every speaker, and you can try your own text in the playground.

Choose a speaker

Each model has its own set of speaker IDs. A speaker from one model is rejected on the other.

bulbul:v4-flashbulbul:v3
Voices200+ personas37 named speakers
ID format<name>_<language>_<style>, for example simran_en_customer. enhi marks English and Hindi code-mixed personas.A single lowercase name, for example shubh
Full listv4 Flash voices, or featured voices by use caseSee below

The language tag in a v4 persona ID is not a restriction. Any supported language_code works with any persona.

Bulbul v3 speakers

GenderSpeakers
Maleshubh (default), aditya, rahul, rohan, amit, dev, ratan, varun, manan, sumit, kabir, aayan, ashutosh, advait, anand, tarun, sunny, mani, gokul, vijay, mohit, rehan, soham
Femaleritu, priya, neha, pooja, simran, kavya, ishita, shreya, roopa, tanya, shruti, suhani, kavitha, rupali

Example

This example uses a bulbul:v4-flash persona. For bulbul:v3, set model to "bulbul:v3" and speaker to a v3 name such as "priya".

import os
from sarvamai import SarvamAI
from sarvamai.play import save
client = SarvamAI(api_subscription_key=os.environ["SARVAM_API_KEY"])
response = client.text_to_speech.convert(
text="Welcome to Sarvam AI!",
language_code="en-IN",
model="bulbul:v4-flash",
speaker="simran_en_customer",
)
save(response, "output.wav")

On WebSocket, set speaker in the configure message. See the WebSocket API.

Common errors

RequestError
Wrong case, such as ShubhHTTP 400: Speaker 'Shubh' is not recognized. Available speakers for bulbul:v4-flash are: ...
shubh (a v3 name) on bulbul:v4-flashHTTP 400: Speaker 'shubh' is not compatible with model bulbul:v4-flash. Available speakers for bulbul:v4-flash are: ...

The message lists every valid speaker for the model in the request. On WebSocket, a bad speaker returns a JSON error message with code 422.

Speakers are rated by Critical Error Rate (CER), the percentage of words with critical pronunciation errors. Lower is more reliable. These ratings apply to bulbul:v3 speakers.

TierCER rangeRecommendation
Tier 1: Excellent≤ 0.20%First choice for production
Tier 2: Good0.21–0.40%Safe for production use
Tier 3: Moderate0.41–0.60%Acceptable; test per language first
SpeakerGenderCERQuality Tier
maniMale0.00%Tier 1: Excellent
priyaFemale0.13%Tier 1: Excellent
ishitaFemale0.13%Tier 1: Excellent
varunMale0.06%Tier 1: Special use ★
roopaFemale0.26%Tier 2: Good
shubhMale0.30%Tier 2: Good
poojaFemale0.30%Tier 2: Good
sunnyMale0.33%Tier 2: Good
ratanMale0.33%Tier 2: Good
rehanMale0.33%Tier 2: Good
ashutoshMale0.40%Tier 2: Good
amitMale0.40%Tier 2: Good
rahulMale0.40%Tier 2: Good
adityaMale0.46%Tier 3: Moderate
simranFemale0.46%Tier 3: Moderate
suhaniFemale0.46%Tier 3: Moderate
shreyaFemale0.46%Tier 3: Moderate
anandMale0.46%Tier 3: Moderate
rupaliFemale0.50%Tier 3: Moderate
nehaFemale0.53%Tier 3: Moderate
rituFemale0.53%Tier 3: Moderate
mananMale0.53%Tier 3: Moderate
devMale0.60%Tier 3: Moderate

varun has a very low CER (0.06%) but a deep, dramatic villain or suspense character. Do not use it as a neutral default. Reserve it for thriller, drama or suspense content.

Speakers do not perform equally in every language. Prefer these picks for each language:

LanguageCodeRecommended MaleRecommended Female
Englishen-INratanishita
Hindihi-INshubh, ashutoshpriya, suhani
Telugute-INshubh, ratanneha, priya
Kannadakn-INshubh, ratanneha, ishita
Bengalibn-INrehanroopa, suhani
Tamilta-INratan, rohanishita, ritu
Odiaod-INshubhritu, pooja
Malayalamml-INshubhpooja
Marathimr-INratanpriya, ritu
Punjabipa-INmaniroopa, suhani
Gujaratigu-INratanpriya, ritu

Top picks: priya and ishita (best female, across Hindi, Telugu, Kannada, Tamil, Marathi, Gujarati and English) · mani (best male overall, Punjabi) · shubh (best male for hi, te, kn, od, ml) · ratan (best male for en, te, kn, ta, mr, gu).