Overview

This guide demonstrates how to convert text into speech using the Sarvam AI Text-to-Speech API. The resulting audio files are saved as .wav files.

🛠 Prerequisites

Before running this, ensure you have:

• Python 3.7 or higher
• Python packages: sarvamai

Install the required package using pip:

$
pip install sarvamai

📦 Import Required Libraries

1
from sarvamai import SarvamAI
2
from sarvamai.play import play, save

🔑 Set Up Your API Key

To use the TTS Bulbul API:

1. Sign up at Sarvam AI Dashboard to get your API key.
2. Replace the placeholder key in the code.

1
SARVAM_API_KEY = "YOUR_SARVAM_API_KEY"
2
client = SarvamAI(api_subscription_key=SARVAM_API_KEY)

📄 Example Text Input

1
text = """
2
Netaji Subhash Marg से Dayanand Road की तरफ, south की तरफ़ जाने से शुरू करें।
3
Dayanand Road पर पहुँचने के बाद, बाएँ मुड़ जाएँ। 350 meters तक सीधा चलते रहें।
4
आपको बायें तरफ़, United Bank of India ATM दिखेगा।
5
Dayanand School के दाएँ तरफ़ से गुजरने के बाद, बाएँ मुड़ें।
6
120 meters के बाद, Ghata Masjid Road पर, right turn करें।
7
280 meters तक चलते रहें।
8
Mahatma Gandhi Marg पे रहें और, 2.9 kilometers तक Old Delhi की तरफ जाएँ।
9
फिर, HC Sen Marg पर continue करें, और Paranthe Wali Gali तक drive करें।
10
"""

⚙️ API Parameters

🔁 Convert Text to Speech

1
response = client.text_to_speech.convert(
2
    text="Your Text",
3
    target_language_code="hi-IN",
4
    speaker="anushka",
5
    enable_preprocessing=True,
6
)

▶️ Play or 💾 Save Audio

To play the output:

1
play(response)

To save the output:

1
save(response, "output.wav")

📤 Output

Running the above code saves a output.wav file containing the speech.

✅ Conclusion

This MDX guide showed how to use Sarvam AI’s TTS API to convert Hindi text into lifelike speech. Customize the text, language, voice, and parameters to suit your application.

📚 Additional Resources

• Documentation: docs.sarvam.ai
• Community Support: Join our Discord

🛡️ Note: Keep your API key safe and avoid committing it in public repositories.

🚀 Keep Building!