Inyandiko

Kwemeza

Uduciro Udushushondanga na Birenzeho Umubare, Na: A in i Authorization Umutwempangano.

Authorization: Bearer sk-tts-your-api-key-here

SDKs

Official SDKs make it easy to integrate TTS.ai into your application. Both are open source and available on GitHub.

pip install ttsai

from tts_ai import TTSClient

client = TTSClient(api_key="sk-tts-...")
audio = client.generate(
    text="Hello world!",
    model="kokoro"
)
client.save(audio, "output.wav")

npm install @ttsainpm/ttsai

const { TTSClient } = require('@ttsainpm/ttsai');

const client = new TTSClient({
  apiKey: 'sk-tts-...'
});
const audio = await client.generate({
  input: 'Hello world!',
  model: 'kokoro'
});
await client.saveToFile(audio, 'output.wav');

SHINGIRO

Impera: Bifitanye isano Kuri iyi SHINGIRO. Urugero:, i Impera: ni:

Amabwiriza

Umubare Bya Imibare ku

Imitwe in buri: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Inguzanyo

Umwandiko Kuri

Umwandiko Kuri. Ijwi Idosiye in i Imiterere.

Umubiri

Urugero

curl -X POST https://api.tts.ai/v1/tts/ \
  -H "Authorization: Bearer sk-tts-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kokoro",
    "text": "Hello from TTS.ai! This is a test.",
    "voice": "af_bella",
    "format": "mp3"
  }' \
  --output output.mp3

Imibare, Imibare, Inyungu, Telefoni Imibare, na in Inyandikoporogaramu - Nka - Nka =

Gusobanura	Iyinjiza	Nka
cardinal	1234	one thousand two hundred thirty-four
ordinal	21	twenty-first
date	1999-12-31	December thirty-first, nineteen ninety-nine
time	14:30	two thirty PM
telephone	+1-555-867-5309	plus one five five five eight six seven…
currency	$1,234.56	one thousand two hundred thirty-four dollars and fifty-six cents
spell-out	NASA	N A S A

Itariki Imiterere Mburabuzi Kuri Inyandikoporogaramu kugirango Na Inyandikoporogaramu Na: Inyandikoporogaramu Imiterere =

Urugero

{
  "model": "kokoro",
  "voice": "af_bella",
  "text": "Your appointment is on <say-as interpret-as=\"date\">2026-04-26</say-as> at <say-as interpret-as=\"time\">14:30</say-as>. Please call <say-as interpret-as=\"telephone\">+1-555-867-5309</say-as> if you need to reschedule."
}

Igisubizo

The TTS endpoint queues your request and returns a JSON response with a job UUID. You then poll for the result.

Step 1: Submit request

Response (JSON)

{
  "uuid": "77b71db532874ce98e84a69a2d740d4c",
  "job_id": "f21316bb-aefa-480d-8523-701d1e3184ce",
  "status": "queued",
  "credits_used": 11,
  "credits_remaining": 15000
}

Step 2: Poll for result

GET /v1/speech/results/?uuid=<job_uuid>

Poll this endpoint every 1-2 seconds until status is completed or failed.

Polling response (completed)

{
  "status": "completed",
  "result_url": "https://api.tts.ai/static/downloads/77b71db5.../output.mp3"
}

Polling response (still processing)

{
  "status": "processing"
}

Step 3: Download audio

Fetch the result_url from the completed response to download the audio file.

Full example

Python

import requests, time

API_KEY = "sk-tts-your-key"
BASE = "https://api.tts.ai"

# 1. Submit TTS request
resp = requests.post(f"{BASE}/v1/tts/", json={
    "model": "kokoro",
    "text": "Hello from TTS.ai!",
    "voice": "af_bella"
}, headers={"Authorization": f"Bearer {API_KEY}"})
data = resp.json()
uuid = data["uuid"]

# 2. Poll for result
while True:
    result = requests.get(f"{BASE}/v1/speech/results/",
        params={"uuid": uuid}).json()
    if result["status"] == "completed":
        # 3. Download audio
        audio = requests.get(result["result_url"])
        with open("output.mp3", "wb") as f:
            f.write(audio.content)
        break
    elif result["status"] == "failed":
        raise Exception(result.get("error", "Generation failed"))
    time.sleep(1.5)

Streaming alternative: For supported models (Kokoro, MeloTTS), use POST /v1/tts/stream/ for real-time Server-Sent Events (SSE) streaming — no polling needed.