DocumentationQuickstart

Quickstart

This guide walks you through making your first request to the Oogam API in a few minutes.

1. Create an API key

Sign in and head to Dashboard → API Keys. Create a key and copy it — it's shown only once. Keys look like sk-setu-....

2. Generate speech

The audio endpoint is OpenAI-compatible. This returns a WAV file. Replace $SETU_API_KEY with your key:

bash
curl https://platform.oogam.in/v1/audio/speech \
  -H "Authorization: Bearer $SETU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "naad-tts-v1",
    "voice": "aditi",
    "language": "HIN",
    "input": "नमस्ते, हमारे प्लेटफॉर्म पर आपका स्वागत है।"
  }' --output hello.wav

3. Use the SDK

Prefer a typed client? Install the official SDK and make the same call in a couple of lines:

python
# pip install setu-ai
from setu import Setu

setu = Setu()  # reads SETU_API_KEY

# Text to Speech
speech = setu.tts.speech(
    "नमस्ते, आज मौसम कैसा है?",
    language="HIN",   # 3-letter code
    voice="aditi",
)
speech.save("hello.wav")

# Speech to Text (language is required)
tx = setu.stt.transcribe("hello.wav", language="HIN")
print(tx.text)

Next steps