Natural voices,
one simple key.

curl -X POST {{BASE}}/api/v1/tts \
  -H "Authorization: Bearer {{KEY}}" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello class, welcome to the lesson.", "voice": "{{V:default}}"}' \
  --output speech.mp3

import requests

res = requests.post(
    "{{BASE}}/api/v1/tts",
    headers={"Authorization": "Bearer {{KEY}}"},
    json={"text": "Hello class, welcome to today's lesson.", "voice": "{{V:default}}"},
)
res.raise_for_status()
open("speech.mp3", "wb").write(res.content)
print("Saved", res.headers["X-Audio-Duration"], "seconds")

const res = await fetch("{{BASE}}/api/v1/tts", {
  method: "POST",
  headers: { "Authorization": "Bearer {{KEY}}", "Content-Type": "application/json" },
  body: JSON.stringify({ text: "Hello class, welcome to today's lesson.", voice: "{{V:default}}" }),
});
if (!res.ok) throw new Error((await res.json()).error.message);
const audio = new Audio(URL.createObjectURL(await res.blob()));
audio.play();

Authorization: Bearer {{KEY}}

{
  "id": "q1Xb3mXr0P2kZ8aB",
  "audio_url": "{{BASE}}/files/q1Xb3mXr0P2kZ8aB.mp3",
  "srt_url": "{{BASE}}/files/q1Xb3mXr0P2kZ8aB.srt",
  "duration": 6.74,
  "characters": 68,
  "voice": "{{V:male}}",
  "cues": [[0.05, 1.21, "Hello students."], [2.93, 5.32, "This is a test."]],
  "quota": { "tokens": 1999932, "unlimited": false, "used_today": 68 }
}

{
  "text": "It was a quiet night... Suddenly, the door creaked open! [gasp] Who is there? [whisper] Don't make a sound.",
  "voice": "{{V:male}}",
  "style": "storytelling",
  "emotion": "auto",
  "intensity": 1.2
}

import requests

res = requests.post("{{BASE}}/api/v1/tts",
                    headers={"Authorization": "Bearer {{KEY}}"},
                    json={"text": "I can't believe we **finally** did it! [laugh] Thank you, all of you.",
                          "voice": "{{V:default}}", "style": "podcast", "emotion": "auto"})
open("story.mp3", "wb").write(res.content)

curl "{{BASE}}/api/v1/voices?lang=ur"

{
  "count": 4,
  "voices": [
    { "id": "{{V:urdu_female}}", "name": "{{N:urdu_female}}", "locale": "ur-PK", "lang": "ur",
      "language": "Urdu", "region": "Pakistan", "gender": "Female",
      "multilingual": false, "personalities": ["Friendly", "Positive"] }
  ]
}

import requests

lines = [
    {"voice": "{{V:urdu_male}}", "text": "السلام علیکم! آج ہم کیا پڑھیں گے؟"},
    {"voice": "{{V:urdu_female}}", "text": "آج ہم سائنس کا سبق پڑھیں گے۔"},
]
res = requests.post("{{BASE}}/api/v1/dialogue",
                    headers={"Authorization": "Bearer {{KEY}}"},
                    json={"lines": lines, "gap": 0.4})
open("dialogue.mp3", "wb").write(res.content)

curl -X POST {{BASE}}/api/v1/dialogue \
  -H "Authorization: Bearer {{KEY}}" -H "Content-Type: application/json" \
  -d '{"lines": [
        {"voice": "{{V:male}}", "text": "Ready for the quiz?"},
        {"voice": "{{V:default}}", "text": "Absolutely. Ask me anything!"}
      ]}' --output dialogue.mp3

import requests

srt = open("video.srt", encoding="utf-8").read()
res = requests.post("{{BASE}}/api/v1/srt",
                    headers={"Authorization": "Bearer {{KEY}}"},
                    json={"srt": srt, "voice": "{{V:hindi_female}}", "auto_fit": True})
open("dub.mp3", "wb").write(res.content)

from openai import OpenAI

client = OpenAI(api_key="{{KEY}}", base_url="{{BASE}}/v1")

with client.audio.speech.with_streaming_response.create(
    model="tts-1",
    voice="{{V:urdu_female}}",   # or "nova", "alloy", ...
    input="یہ آواز OpenAI SDK سے بنائی گئی ہے۔",
) as response:
    response.stream_to_file("speech.mp3")

import OpenAI from "openai";
import fs from "node:fs";

const client = new OpenAI({ apiKey: "{{KEY}}", baseURL: "{{BASE}}/v1" });
const mp3 = await client.audio.speech.create({ model: "tts-1", voice: "nova", input: "Hello from Node!" });
fs.writeFileSync("speech.mp3", Buffer.from(await mp3.arrayBuffer()));

{
  "kind": "key",
  "name": "Ayesha Khan",
  "quota": {
    "tokens": 1996880, "unlimited": false, "used_today": 3120,
    "max_request_chars": 100000, "expires_at": null
  }
}

{ "error": { "code": "insufficient_tokens", "message": "Not enough tokens: this needs 5,200 but the key has 1,040 left." } }