Text-to-Speech Rest API

Provides a synchronous REST endpoint where a POST request with text returns base64-encoded audio as response.

Common use cases:

• Story narration — Generate expressive audio for audiobooks and narratives
• Podcast generation — Create natural-sounding voiceovers for episodes at scale
• Content creation — Add voice to blogs, articles, and social media posts
• E-learning — Build multilingual course material with clear pronunciation

What You Can Do

Model: Bulbul v3

Bulbul v3 is purpose-built for Indian languages and accents. It handles code-mixed text (e.g., Hinglish), number normalization, and natural prosody out of the box — with minimal preprocessing needed.

Text to Speech Features

1
from sarvamai import SarvamAI
2
from sarvamai.play import save
3
4
client = SarvamAI(api_subscription_key="YOUR_SARVAM_API_KEY")
5
# Convert text to speech
6
audio = client.text_to_speech.convert(
7
    target_language_code="en-IN",
8
    text="Welcome to Sarvam AI!",
9
    model="bulbul:v3",
10
    speaker="shubh"
11
)
12
save(audio, "output1.wav")

API Response Format

Supported audio formats: WAV (default), MP3, Linear16, Mulaw, Alaw, Opus, FLAC, AAC

1
{
2
  "request_id": "20241115_12345678-1234-5678-1234-567812345678",
3
  "audios": [
4
    "UklGRiQAAABXQVZFZm10IBAAAAABAAEAQB8AAAB9AAACABAAZGF0YQAAAAA..."
5
  ]
6
}

1
import base64
2
3
audio_base64 = response.audios[0]
4
audio_bytes = base64.b64decode(audio_base64)
5
6
with open("output.wav", "wb") as f:
7
    f.write(audio_bytes)

1
import fs from "fs";
2
3
const audioBase64 = response.audios[0];
4
const audioBuffer = Buffer.from(audioBase64, 'base64');
5
fs.writeFileSync('output.wav', audioBuffer);

Error Responses

All errors return a JSON object with an error field containing details about what went wrong.

Error Response Structure

1
{
2
  "error": {
3
    "message": "Human-readable error description",
4
    "code": "error_code_for_programmatic_handling",
5
    "request_id": "unique_request_identifier"
6
  }
7
}

Error Codes Reference

Example Error Response

1
{
2
  "error": {
3
    "message": "Text exceeds maximum length of 1500 characters for bulbul:v3",
4
    "code": "unprocessable_entity_error",
5
    "request_id": "20241115_abc12345"
6
  }
7
}

1
from sarvamai import SarvamAI
2
from sarvamai.core.api_error import ApiError
3
4
client = SarvamAI(api_subscription_key="YOUR_SARVAM_API_KEY")
5
6
try:
7
    response = client.text_to_speech.convert(
8
        text="Welcome to Sarvam AI!",
9
        target_language_code="en-IN",
10
        speaker="shubh",
11
        model="bulbul:v3"
12
    )
13
    # Process audio...
14
except ApiError as e:
15
    if e.status_code == 400:
16
        print(f"Bad request: {e.body}")
17
    elif e.status_code == 403:
18
        print("Invalid API key. Check your credentials.")
19
    elif e.status_code == 422:
20
        print(f"Invalid parameters: {e.body}")
21
    elif e.status_code == 429:
22
        print("Rate limit exceeded. Wait and retry.")
23
    else:
24
        print(f"Error {e.status_code}: {e.body}")