Developers

API Reference

Speech-to-Text, Text-to-Speech, Speech-to-Speech and Translation for Indian languages — over REST, HTTP streaming and WebSocket.

Base URLs

RESThttps://api.shabd.tech/v1
WebSocketwss://stream.shabd.tech/v1

Authentication

Send your API key in the x-api-key header on every request. Requests also carry a x-request-id — a unique UUID per call, useful when contacting support.

x-api-key: <your-api-key>
x-request-id: 550e8400-e29b-41d4-a716-446655440000

Ways to call

REST

One request, one JSON (or audio) response. Simplest way to process a complete file or text.

HTTP Stream

Same request as REST, but results arrive incrementally over one chunked connection — newline-delimited JSON or audio chunks.

WebSocket

Bidirectional and real-time. Send a JSON metadata message, then stream audio or text; results stream back as they are ready.

Endpoints

Speech To Text

Speech To Text Translate

Speech To Speech

Text Translation

Text To Speech

Text Translate To Speech

Errors

Failed requests return status: false with a message.

400Bad Request - The request is malformed or contains invalid parameters.
401Unauthorized Access - Authentication credentials are missing or invalid.
403Usage Limit Exceeded - The usage limit for the API has been exceeded.
500Internal server error