How to adjust the loudness (volume)

The loudness parameter controls the volume level of the generated audio.

It is optional — if omitted, the default value 1.0 (normal loudness) is used.

Valid range: 0.1 (quietest) to 3.0 (loudest)
Values < 1.0 reduce volume; values > 1.0 increase volume.

Example Code

Rest API

Streaming API

1 from sarvamai import SarvamAI
2 from sarvamai.play import save
3 
4 # Initialize the REST client
5 client = SarvamAI(api_subscription_key="YOUR_API_SUBSCRIPTION_KEY")
6 
7 # Generate speech using REST
8 audio = client.text_to_speech.convert(
9     text="Welcome to Sarvam AI!",
10     model="bulbul:v2",
11     target_language_code="en-IN",
12     loudness=2.0  # Increase loudness for a louder output
13 )
14 save(audio, "output1.wav")