Developer Quickstart

Get started with Sarvam APIs in 30 seconds: create a key, install the SDK, and make your first call with just a few lines of code.

Prerequisites:

• A Sarvam AI account and API key. Create one on the dashboard if you don’t have one yet.
• Python 3.9+ or Node.js 18+ (or skip both and call the REST API directly with curl).

By the end of this quickstart, you’ll have made a live call to a Sarvam AI API and gotten back a real result: a transcript, a playable audio file, a translation, or a chat reply, depending on which API you try below.

Setup

$
export SARVAM_API_KEY="YOUR_SARVAM_API_KEY"

$
pip install -U sarvamai

1
from sarvamai import SarvamAI
2
3
client = SarvamAI(
4
    api_subscription_key="YOUR_SARVAM_API_KEY",
5
)
6
7
response = client.chat.completions(
8
    model="sarvam-105b",
9
    messages=[
10
        {"role": "user", "content": "What is the capital of India?"}
11
    ],
12
)
13
print(response.choices[0].message.content)
14
# → "The capital of India is New Delhi."

Try an API

Sarvam AI covers four core capabilities below. Pick a tab, and copy-paste your way to a working call.

1
from sarvamai import SarvamAI
2
3
client = SarvamAI(
4
    api_subscription_key="YOUR_SARVAM_API_KEY",
5
)
6
7
try:
8
    response = client.speech_to_text.transcribe(
9
        file=open("audio.wav", "rb"),  # path to your own audio file
10
        model="saaras:v3",
11
        mode="transcribe",  # or "translate", "verbatim", "translit", "codemix"
12
    )
13
    print(response.transcript)
14
except Exception as e:
15
    print(f"Error: {e}")

Next Steps

Pick up where you left off, based on the API you just tried: