Libraries & SDKs

1
from sarvamai import SarvamAI
2
3
client = SarvamAI(api_subscription_key="YOUR_SARVAM_API_KEY")
4
5
response = client.text.translate(
6
    input="Hello, how are you?",
7
    source_language_code="auto",
8
    target_language_code="hi-IN",
9
)
10
print(response)

1
import asyncio
2
from sarvamai import AsyncSarvamAI
3
4
client = AsyncSarvamAI(api_subscription_key="YOUR_SARVAM_API_KEY")
5
6
async def main():
7
    # Run several translations concurrently
8
    inputs = ["Good morning", "How are you?", "Thank you"]
9
    results = await asyncio.gather(*[
10
        client.text.translate(
11
            input=text,
12
            source_language_code="en-IN",
13
            target_language_code="hi-IN",
14
        )
15
        for text in inputs
16
    ])
17
    for r in results:
18
        print(r)
19
20
asyncio.run(main())

1
from sarvamai import SarvamAI
2
3
# Client-level: applies to every request
4
client = SarvamAI(
5
    api_subscription_key="YOUR_SARVAM_API_KEY",
6
    timeout=30.0,  # seconds
7
)
8
9
# Per-request: override timeout and set automatic retries
10
response = client.text.translate(
11
    input="Hello, how are you?",
12
    source_language_code="auto",
13
    target_language_code="hi-IN",
14
    request_options={
15
        "timeout_in_seconds": 60,
16
        "max_retries": 3,
17
    },
18
)

1
from sarvamai import SarvamAI, TooManyRequestsError
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.translate(
8
        input="Hello, how are you?",
9
        source_language_code="auto",
10
        target_language_code="hi-IN",
11
    )
12
except TooManyRequestsError:
13
    print("Rate limited — back off and retry")
14
except ApiError as e:
15
    # Base class for every API error
16
    print(f"API error {e.status_code}: {e.body}")

$
pip install --upgrade sarvamai