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}")

1
import os, time
2
from sarvamai import SarvamAI
3
4
client = SarvamAI(api_subscription_key=os.environ["SARVAM_API_KEY"])
5
6
# `file` takes a list of (filename, fileobj, content_type) tuples
7
with open("document.pdf", "rb") as f:
8
    job = client.doc_ai.digitise(
9
        file=[("document.pdf", f, "application/pdf")],
10
        language="hi-IN",
11
        output_format="md",   # "html" (default) or "md"
12
    )
13
14
TERMINAL = {"completed", "partially_completed", "failed", "rejected"}
15
while True:
16
    st = client.doc_ai.get_status(job_id=job.job_id)
17
    if st.status.lower() in TERMINAL:
18
        break
19
    time.sleep(5)
20
21
dl = client.doc_ai.get_download_url(job_id=job.job_id)
22
print("download:", dl.method, dl.url)

$
pip install --upgrade sarvamai