API Reference

Text Translate To Speech · HTTP Stream

POSThttps://api.shabd.tech/v1/text-translate-to-speech/stream

Translates text and synthesizes the translation to audio — streamed as NDJSON (a ttt line, then progressive tts lines) over one chunked connection.

Headers

x-api-keystringrequired
API Key for authentication
Example:
<your-api-key>
Content-Typestringrequired
Content type of the request body
Example:
application/json
x-request-idstringrequired
Unique request ID in UUID format
Example:
550e8400-e29b-41d4-a716-446655440000

Request bodyapplication/json

textstringrequired
Text to translate and synthesize
Example:
Without language, we cannot communicate.
sourceLanguagestringrequired
Language of the input text
Example:
english
targetLanguagestringrequired
Language to translate and synthesize into
Example:
tamil
genderstringrequired
Voice gender ("male" or "female")
Example:
male
sampleRateintegeroptional
Output audio sample rate in Hz
Example:
48000
speedstringoptional
Speed of speech (fast, normal, or slow). Default is normal if not specified.
Example:
normal
formatstringoptional
Output audio format (default "wav")
Example:
wav
stylestringoptional
Translation style ("conversational" or "formal")
Allowed:
conversational
formal
Default:
conversational
wordStreambooleanoptional
When true, each tts line carries the word its audio speaks in the word field. When false or omitted, word is present but empty.
Default:
false
Example:
true
projectIdstringoptional
Optional project identifier
Example:
<your-project-id-here>

Responses

200NDJSON stream — one JSON object per line, newline-separated.

mode	Example line
ttt	`{ "requestId": "a216e43a-9d81-444c-a9ae-3c1e400fcb02", "mode": "ttt", "status": true, "completed": true, "chunk": 1, "translation": "வணக்கம் உலகம்" }`
tts	`{ "requestId": "a216e43a-9d81-444c-a9ae-3c1e400fcb02", "mode": "tts", "status": true, "completed": false, "chunk": 1, "audio": "<base64 PCM-16>", "word": "வணக்கம்", "sampleRate": 48000, "format": "pcm" }`

The single ttt line is completed: true. Every audio-bearing tts line is completed: false; a single terminal tts line with empty audio and completed: true marks the end of the stream.

word holds the word that line's audio speaks, mirroring the word stream of /text-to-speech/stream. It is populated only when wordStream: true was requested; otherwise it is an empty string. Concatenating word across the tts lines reproduces the translation in playback order. On failure a single error line is sent: { "requestId": "a216e43a-9d81-444c-a9ae-3c1e400fcb02", "status": false, "completed": false, "message": "An unexpected error occurred. Please try again later." }

Body: application/x-ndjson

Example response

"string"

400Bad Request
Bodyapplication/json
statusbooleanoptional
Example:
false
messagestringoptional
Example:
Invalid input parameters.
Example response
```
{  "status": false,  "message": "Invalid input parameters."}
```
401Unauthorized Access
Bodyapplication/json
statusbooleanoptional
Example:
false
messagestringoptional
Example:
Unauthorized access.
Example response
```
{  "status": false,  "message": "Unauthorized access."}
```
403Usage Limit Exceeded
Bodyapplication/json
statusbooleanoptional
Example:
false
messagestringoptional
Example:
Limit Exceeded
Example response
```
{  "status": false,  "message": "Limit Exceeded"}
```
500Internal server error
Bodyapplication/json
statusbooleanoptional
Example:
false
messagestringoptional
Example:
An unexpected error occurred. Please try again later.
Example response
```
{  "status": false,  "message": "An unexpected error occurred. Please try again later."}
```

Request

1curl -X POST "https://api.shabd.tech/v1/text-translate-to-speech/stream" \2 -H "x-api-key: <your-api-key>" \3 -H "Content-Type: application/json" \4 -H "x-request-id: <your-uuid-here>" \5 -d '{"text":"Without language, we cannot communicate.","sourceLanguage":"english","targetLanguage":"tamil","gender":"male","sampleRate":48000,"speed":"normal"}' \6 -N

1import requests2import json3import base644import wave5 6url = "https://api.shabd.tech/v1/text-translate-to-speech/stream"7headers = {8    "x-api-key": "<your-api-key>",9    "Content-Type": "application/json",10    "x-request-id": "<your-uuid-here>"11}12sample_rate = 4800013data = {14    "text": "Without language, we cannot communicate.",15    "sourceLanguage": "english",16    "targetLanguage": "tamil",17    "gender": "male",18    "sampleRate": sample_rate,19    "speed": "normal"20}21 22with requests.post(url, json=data, headers=headers, stream=True) as r:23    r.raise_for_status()24    for line in r.iter_lines():25        if not line:26            continue27        msg = json.loads(line.decode("utf-8"))28        status = msg.get("status")29        translation = msg.get("translation")30        audio = msg.get("audio")31        chunk = msg.get("chunk")32        completed = msg.get("completed")33        mode = msg.get("mode")34 35        if not status:36            print("Error:", msg.get("message"))37            break38        if translation:39            print(f"Translation {chunk}: {translation}")40        if completed and mode == "ttt":41            print("Translation completed")42        if audio:43            pcm = base64.b64decode(audio)44            with wave.open(f"SynthesizedAudio_Chunk{chunk}.wav", "wb") as wf:45                wf.setnchannels(1)46                wf.setsampwidth(2)47                wf.setframerate(sample_rate)48                wf.writeframes(pcm)49            print(f"Saved audio chunk {chunk}: {len(pcm)} bytes")50        if completed and mode == "tts":51            print("Audio synthesis completed")52            break

1// npm install node-fetch wav2const fetch = require("node-fetch");3const wav = require("wav");4 5const url = "https://api.shabd.tech/v1/text-translate-to-speech/stream";6const sampleRate = 48000;7 8const response = await fetch(url, {9    method: "POST",10    headers: {11        "x-api-key": "<your-api-key>",12        "Content-Type": "application/json",13        "x-request-id": "<your-uuid-here>"14    },15    body: JSON.stringify({16        text: "Without language, we cannot communicate.",17        sourceLanguage: "english",18        targetLanguage: "tamil",19        gender: "male",20        sampleRate,21        speed: "normal"22    })23});24 25let buffer = "";26for await (const value of response.body) {27    buffer += value.toString("utf-8");28    const lines = buffer.split("\n");29    buffer = lines.pop();30    for (const line of lines) {31        if (!line.trim()) continue;32        const msg = JSON.parse(line);33        const { status, translation, audio, chunk, completed, mode } = msg;34 35        if (!status) { console.error("Error:", msg.message); break; }36        if (translation) console.log(`Translation ${chunk}: ${translation}`);37        if (completed && mode === "ttt") console.log("Translation completed");38        if (audio) {39            const writer = new wav.Writer({ channels: 1, sampleRate, bitDepth: 16 });40            writer.pipe(fs.createWriteStream(`SynthesizedAudio_Chunk${chunk}.wav`));41            writer.write(Buffer.from(audio, "base64"));42            writer.end();43            console.log(`Saved audio chunk ${chunk}`);44        }45        if (completed && mode === "tts") { console.log("Audio synthesis completed"); break; }46    }47}

Text Translate To Speech · HTTP Stream

Headers

Request bodyapplication/json

Responses

Bodyapplication/json

Bodyapplication/json

Bodyapplication/json

Bodyapplication/json