Bulbul
Bulbul v4 Flash is our latest text-to-speech model. It offers 200+ persona voices and uses the same API contract as Bulbul v3. Bulbul v3 remains the API default when model is omitted and offers 30+ classic speaker names. Both models accept up to 2500 characters per request.
At a Glance
Bulbul v4 Flash vs v3
To use Bulbul v4 Flash, set model="bulbul:v4-flash" and pick a speaker from the voice catalog. Everything else in your request stays the same.
Key Features
Language Support
Both models accept the same 11 languages, set with the language_code parameter. Bulbul v4 Flash has dedicated personas for nine of them. Malayalam and Odia work with any v4 persona, and the language code selects the language of the text.
Bulbul reads code-mixed text such as Hindi with English words. Write Indic words in their native script (for example आपका order confirm हो गया है) for the best quality.
Available Speakers
Bulbul v3
Bulbul v3 has 37 named speakers. shubh is the default.
shubh, aditya, ritu, priya, neha, rahul, pooja, rohan, simran, kavya, amit, dev, ishita, shreya, ratan, varun, manan, sumit, roopa, kabir, aayan, ashutosh, advait, anand, tanya, tarun, sunny, mani, gokul, vijay, shruti, suhani, mohit, kavitha, rehan, soham, rupali
Bulbul v4 Flash
Bulbul v4 Flash has 200+ persona voices. A persona ID has three parts: a voice name, a language tag, and a style.
For example, simran_en_customer is Simran speaking English in a customer-care style. Browse every persona, with audio samples, on the Voices page.
If you omit speaker on bulbul:v4-flash, the default is shubh_enhi_ads. Names from bulbul:v3 such as shubh are not valid on v4 Flash, and v4 persona IDs are not valid on v3. Using the wrong one returns a 400 that lists the speakers the model accepts.
Quickstart
Basic Usage
Speaker Selection
Sample Rate Control
Convert text to speech with Bulbul v4 Flash, recommended for new integrations.
The response is JSON with a request_id and an audios array. Each item is base64-encoded audio, WAV by default, so decode it before playing. The SDK’s save() helper does this for you.
Limits and Defaults
All values apply to both bulbul:v3 and bulbul:v4-flash. opus works at 8000, 16000, 24000 and 48000 Hz. At the default 22050 Hz it returns a 400, so set speech_sample_rate when you use it.