Dokumentatioun
D'Integratioun vun TTS.ai an Är Applikatiounen mat eiser REST API. OpenAI-kompatibelt Format fir einfach Migratioun.
Iwwersiicht
D'TTS.ai API bitt programmateschen Zougang zu all Plattformfeatures: Text-to-Speech Synthese, Speech-to-Text Transkriptioun, Stëmm Klonen, Audioverbesserung, a méi. D'API benotzt Standard REST Konventiounen mat JSON Request/Response Bodyen.
API Schlëssel
Gitt Ären API Schlëssel heihier Kont-Einstellungen. Et gëtt och en Enterprise-Programm.
Basis-URL
https://api.tts.ai/v1/
Auth
Lëscht vu lëtzebuergesche Schrëftsteller Authorization Kopfzeil
Authentifikatioun
/v1/tts/ schaffen ouni Auth, bis zu 5.000 Zeichen/Dag pro IP, mat all eise gratis Modeller (piper, vits, melotts, kokoro). Et gëtt eng 15.000 Aarten, déi an 15 Famillen a 15 Geschlechter ënnerdeelt ginn.
All API-Ufroen erfuerderen eng Authentifizéierung iwwer e Bearer-Token am Authorization Kopfzeil.
Authorization: Bearer sk-tts-your-api-key-here
SDKs
Offiziell SDKs maachen et einfach, TTS.ai an Är Applikatioun ze integréieren. Beide sinn Open Source a verfügbar op GitHub.
Python
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")
JavaScript / Node.js
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');
Basis-URL
All Endpunkte sinn relativ zu dëser Basis- URL. Zum Beispill ass den TTS- Endpunkt:
Geschwindegkeetsbegrenzung
D'Gréisst vun de Planzen variéiert.
| Planz | Ufroen/min | Gläichzäiteg | Maximal Textlängt |
|---|---|---|---|
| Free | 10 | 2 | 500 Zeichen |
| Starter | 30 | 3 | 1.000.000 Zeilen |
| Pro | 60 | 5 | 1.000.000 Zeilen |
| Enterprise | 300 | 20 | 50.000 Zeilen |
Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
Kreditkoart
| Service | Käschte | Eenheet |
|---|---|---|
| TTS (Fräi Modeller: Piper, VITS, MeloTTS) | 1 Kredit | pro 1. 000 Zeichen |
| D'Standard-Modeller (Kokoro, CosyVoice 2, etc.) | 2 Punkten | pro 1. 000 Zeichen |
| Den Haaptuert ass Tourcoing (fréier: Tourcoing, Tourcoing, etc.). | 4 Punkten | pro 1. 000 Zeichen |
| Sprooch op Text | 2 Punkten | per minute of audio |
| Stëmmklonung | 4 Punkten | pro 1. 000 Zeichen |
| Stimmwiessel | 3 Punkten | per minute of audio |
| Audioverbesserung | 2 Punkten | per minute of audio |
| Lëscht vu lëtzebuergesche Schrëftsteller | 3-4 Säiten. | per minute of audio |
| Sproochiwwersetzung | 5 Punkten | per minute of audio |
| Stëmmchat | 3 Punkten | pro Zyklus |
| Key & BPM Finder | Fräi | -- |
| Audiokonverter | Fräi | -- |
Text- op- Sprooch
Konvertéiert Text an Sprooch. Gitt eng Audiodatei am ugefuerderte Format zréck.
Ufrokörper
| Parameter | Typ | Erfuerderlech | Beschreiwung |
|---|---|---|---|
| model | string | Nee | Modell-ID (z. B. kokoro, chatterbox, piper) |
| text | string | Ja | Text fir an Sprooch ze konvertéieren (max. 5.000 Zeichen fir Pro, 50.000 fir Enterprise) |
| voice | string | Ja | Stëmm-ID (Benotzt /v1/voices/ fir verfügbar Stimmen opzelëschten) |
| format | string | Nee | Ausgabeformat: mp3 (Standard), wav, flac, ogg |
| speed | float | Nee | Multiplikator fir d'Sproochgeschwindegkeet. Standard: 1.0. Beräich: 0.5 bis 2.0 |
| language | string | Nee | Sproochcode (z.B. en, es). Automatesch erkannt wann net uginn. |
| instructions | string | Nee | D'Spill ass op 5000 (oder 10000) Kaarten opgebaut. |
| pronunciations | object | array | Nee | D'Aussprooch gëtt pro Ufro iwwerschriwwen. Entweder {\ |
| stream | boolean | Nee | Streaming-Äntwert aktivéieren. Standard: false |
D'Ufro
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
SSML Tags
Zifferen, Datumer, Währungen, Telefonsnummeren an Akronymer an D'Datumsformat ass standardméisseg The TTS endpoint queues your request and returns a JSON response with a job UUID. You then poll for the result. Poll this endpoint every 1-2 seconds until Fetch the Streaming alternative: For supported models (Kokoro, MeloTTS), use
interpret-as Input Gesot als cardinal1234one thousand two hundred thirty-four ordinal21twenty-first date1999-12-31Dezember 1939, S. 19 time14:30two thirty PM telephone+1-555-867-5309plus one five five five eight six seven… currency$1,234.56one thousand two hundred thirty-four dollars and fifty-six cents spell-outNASAN A S A mdy fir d'Lëtzebuerger an dmy anerersäits; iwwerschreift mat format=\{
"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."
}Äntwert
Step 1: Submit request
{
"uuid": "77b71db532874ce98e84a69a2d740d4c",
"job_id": "f21316bb-aefa-480d-8523-701d1e3184ce",
"status": "queued",
"credits_used": 11,
"credits_remaining": 15000
}Step 2: Poll for result
status is completed or failed.{
"status": "completed",
"result_url": "https://api.tts.ai/static/downloads/77b71db5.../output.mp3"
}{
"status": "processing"
}Step 3: Download audio
result_url from the completed response to download the audio file.Vollstänneg Lëscht
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)POST /v1/tts/stream/ for real-time Server-Sent Events (SSE) streaming — no polling needed.
Sprooch op Text
Audio an Text ëmwandelen. Ënnerstëtzt 99 Sproochen mat automatescher Erkennung.
Ufrokörper (multipart/form-data)
| Parameter | Typ | Erfuerderlech | Beschreiwung |
|---|---|---|---|
| file | file | Ja | Audiodatei (MP3, WAV, FLAC, OGG, M4A, MP4, WebM). Max 100MB. |
| model | string | Nee | STT-Modell: whisper (Standard), faster-whisper, sensevoice |
| language | string | Nee | D'Code-Sprooche sinn d'Code-Sproochen (Code-Languages) an d'Code-Sproochen (Code-Languages). |
| timestamps | boolean | Nee | Zäitstempel op Wuertniveau abezéien. Standard: false |
| diarize | boolean | Nee | Lautsprecherdiariséierung aktivéieren. Standard: false |
Äntwert
{
"text": "Hello, this is a transcription test.",
"language": "en",
"duration": 3.5,
"segments": [
{
"start": 0.0,
"end": 1.8,
"text": "Hello, this is",
"speaker": "SPEAKER_00"
},
{
"start": 1.8,
"end": 3.5,
"text": "a transcription test.",
"speaker": "SPEAKER_00"
}
]
}
Stëmmklonung
Sprooch an enger geklonter Stëmm generéieren. Referenz-Audio an -Text erofladen.
Ufrokörper (multipart/form-data)
| Parameter | Typ | Erfuerderlech | Beschreiwung |
|---|---|---|---|
| reference_audio | file | Ja | Referenz Stëmm Audio (10-30 Sekonnen empfohlen). Max 20MB. |
| text | string | Ja | Den Haaptuert ass Clohars-Carnoët. |
| model | string | Nee | Klonmodell: chatterbox (Standard), cosyvoice2, gpt-sovits |
| format | string | Nee | Ausgabeformat: mp3 (Standard), wav, flac |
| language | string | Nee | Code vun der Zilsprooch. Et muss vum ausgewielte Modell ënnerstëtzt ginn. |
Äntwert
Gitt d'Audiodatei als Binärdaten zréck, déi selwecht wéi den TTS-Ennpunkt.
Stimmwiessel
Audio ëmwandelen fir wéi eng aner Stëmm ze klingen. Quell-Audio laden an eng Zilstëmm wielen.
Ufrokörper (multipart/form-data)
| Parameter | Typ | Erfuerderlech | Beschreiwung |
|---|---|---|---|
| file | file | Ja | Quell-Audiodatei (MP3, WAV, FLAC). Max 50MB. |
| target_voice | string | Ja | Ziel-Stëmm-ID fir ze konvertéieren (Benotzt /v1/voices/ fir verfügbar Stimmen opzelëschten) |
| model | string | Nee | Stëmmkonversiounsmodell: openvoice (Standard), knn-vc |
| format | string | Nee | Ausgabeformat: wav (Standard), mp3, flac |
D'Ufro
curl -X POST https://api.tts.ai/v1/voice-convert/ \
-H "Authorization: Bearer sk-tts-your-key" \
-F "file=@source_audio.mp3" \
-F "target_voice=af_bella" \
-F "model=openvoice" \
-o converted.wav
Äntwert
Gitt d' ëmgewandelt Audiodatei als Binärdaten zréck.
Sproochiwwersetzung
Iwwersetzt gesot Audio vun enger Sprooch an eng aner. Kombinéiert Sprooch-zu-Text, Iwwersetzung a Text-zu-Sprooch an engem eenzegen Uruff.
Ufrokörper (multipart/form-data)
| Parameter | Typ | Erfuerderlech | Beschreiwung |
|---|---|---|---|
| file | file | Ja | Quell-Audiodatei an der Originalsprooch. Max 100MB. |
| target_language | string | Ja | Code vun der Zilsprooch (z. B. es, fr, de, ja) |
| voice | string | Nee | Sprooch fir d'iwwersat Ausgabe. Automatesch ausgewielt wann net opginn. |
| preserve_voice | boolean | Nee | Versuchen, den urspréngleche Sprecher ze behalen |
Äntwert
{
"original_text": "Hello, how are you?",
"translated_text": "Hola, como estas?",
"source_language": "en",
"target_language": "es",
"audio_url": "https://api.tts.ai/v1/results/translate_abc123.mp3",
"credits_used": 5
}
Speech to Speech
Transforméiert de Sproochstil, d'Emotioun oder d'Liesung andeems Dir den Inhalt behält. Nützlech fir den Ton, d'Tempo an d'Ausdrécklechkeet unzepassen.
Ufrokörper (multipart/form-data)
| Parameter | Typ | Erfuerderlech | Beschreiwung |
|---|---|---|---|
| file | file | Ja | Quell- Audiodatei fir Sprooch. Max 50MB. |
| voice | string | Ja | Ziel-Stëmm-ID fir d'Ausgabe-Sprooch |
| model | string | Nee | Modell: openvoice (Standard), chatterbox |
| emotion | string | Nee | D'Resultat ass d'Resultat vun der Kombinatioun vun den Elementer a, b, c, d an e. |
| speed | float | Nee | Geschwindegkeetsaanpassung. Standard: 1.0. Beräich: 0.5 bis 2.0 |
Äntwert
Gitt d'transforméiert Audiodatei als Binärdaten zréck.
Audio-Tools
D'Resultat vun dësem Prozess ass d'Verstäerkung, d'Verstäerkung, d'Verstäerkung, d'Verstäerkung.
D'Resultat ass eng verbessert Leeschtung, méi Stabilitéit, méi Präzisioun an e bessere Sound.
| file file | Audiodatei fir ze verbesseren |
| denoise boolean | Anti- Rauschen aktivéieren (Standard: true) |
| enhance_clarity boolean | Sproochklarheet verbesseren (Standard: true) |
| super_resolution boolean | Audioqualitéit erhéijen (Standard: falsch) |
| strength integer | 1- 3 (liicht, mëttel, staark). Standard: 2 |
Et gëtt verschidden Aarte vun Instrumenter (oder Instrumentergruppen) fir d'Spill.
| file file | Audiodatei fir ze trennen |
| model string | demucs (Standard) oder spleeter |
| stems integer | Zuel vun de Stämm: 2, 4, 5 oder 6 (Standard: 2) |
| format string | Ausgabeformat: wav, mp3, flac |
Et gëtt och en Audio-CD-Recorder.
| file file | Audiodatei ze verarbeiten |
| type string | echo or reverb (default: both) |
| intensity integer | 1-5 (default: 3) |
Analyséiert Audio fir Schlëssel, BPM, a Taktsignatur ze detektéieren.
| file file | Audiodatei fir ze analyséieren |
{
"key": "C",
"scale": "Major",
"bpm": 120.0,
"time_signature": "4/4",
"camelot": "8B",
"compatible_keys": ["C Major", "G Major", "F Major", "A Minor"]
}
Audio tëscht Formaten ëmwandelen.
| file file | Ze konvertéierend Audiodatei |
| format string | Zilformat: mp3, wav, flac, ogg, m4a, aac |
| bitrate integer | Ausgangsbitrate a kbps: 64, 128, 192, 256, 320 |
| sample_rate integer | Abrëll 2018, S. 450, 451, 452 |
| channels string | mono oder stereo |
Stëmmchat
Et gëtt och Texter oder Audiodateien, déi mat engem Synthesizer gespillt ginn.
Ufrokörper (multipart/form-data oder JSON)
| Parameter | Typ | Erfuerderlech | Beschreiwung |
|---|---|---|---|
| audio | file | Nee* | Audioinput (entweder audio oder text erfuerderlech) |
| text | string | Nee* | Textinput (entweder audio oder text erfuerderlech) |
| voice | string | Nee | Stëmm fir KI-Äntwert. Standard: af_bella |
| tts_model | string | Nee | TTS-Modell fir d'Äntwert. Standard: kokoro |
| system_prompt | string | Nee | Eegen Systemprompt fir d'KI |
| conversation_id | string | Nee | En existent Gespréich weiderféieren |
Äntwert
{
"conversation_id": "conv_abc123",
"user_text": "What is the capital of France?",
"ai_text": "The capital of France is Paris.",
"audio_url": "https://api.tts.ai/v1/audio/tmp/resp_xyz.mp3",
"credits_used": 3
}
Batch TTS
Verschidde Texter fir parallel TTS- Generéierung schécken. Optiounsweis e Webhook- Callback kréien, wann all Aufgaben ofgeschloss sinn.
Parameter
| Parameter | Typ | Beschreiwung |
|---|---|---|
| texts | array | Array of objects: {text, model, voice}. Max 50 items. |
| webhook_url | string | Optiounen fir d'URL fir POST Resultater wann de Batch fäerdeg ass. |
Äntwert
{
"batch_id": "abc123",
"total": 3,
"completed": 0,
"status": "processing"
}
Abrëll 2011, S. 12. (fr) Lëscht vun de lëtzebuergesche Gemengen (fr) Lëscht vun de Gemengen (fr)
Stëmmembezeechnung
Berechent virdrun eng Stëmm-Embedding aus dem Referenz-Audio. Benotzt d'erëmginn embed_id an nofolgenden Stëmm-Klon-Ufroen fir eng quasi-aktuell Generéierung.
Parameter
| Parameter | Typ | Beschreiwung |
|---|---|---|
| file | file | Reference audio file (WAV, MP3, FLAC). |
| model | string | Cloning model (default: chatterbox). Supported: chatterbox, cosyvoice2, openvoice, gpt-sovits, spark, indextts2, qwen3-tts. |
Äntwert
{
"embed_id": "emb_abc123",
"model": "chatterbox",
"duration_ms": 450
}
Statuskontrolle
Kontrolléiert de Status vum GPU-Server, geladen Modeller an d'Gréisst vun der Warteschlange. Keng Authentifizéierung erfuerderlech. 30 Sekonnen am Cache.
Äntwert
{
"status": "online",
"latency_ms": 45,
"queue_size": 3,
"models_loaded": ["kokoro", "chatterbox", "cosyvoice2"]
}
Modellen opzielen
Gitt eng Lëscht vun alle verfügbare Modeller mat hire Fäegkeeten zréck.
Äntwert
{
"models": [
{
"id": "kokoro",
"name": "Kokoro",
"type": "tts",
"tier": "standard",
"languages": ["en", "ja", "ko", "zh", "fr"],
"supports_cloning": false,
"supports_streaming": true,
"credits_per_1k_chars": 2
},
{
"id": "chatterbox",
"name": "Chatterbox",
"type": "tts",
"tier": "premium",
"languages": ["en"],
"supports_cloning": true,
"supports_streaming": true,
"credits_per_1k_chars": 4
}
]
}
Lëscht vu Stëmmen
Gitt eng Lëscht vun alle verfügbare Stëmmen zréck, méiglecherweis no Modell oder Sprooch gefiltert.
Parameter
| Parameter | Typ | Beschreiwung |
|---|---|---|
| model | string | Filter no Modell-ID (z. B. kokoro) |
| language | string | Filter no Sproochcode (z. B. lu) |
| gender | string | Filter no Geschlecht: male, female, neutral |
Äntwert
{
"voices": [
{
"id": "af_bella",
"name": "Bella",
"model": "kokoro",
"language": "en",
"gender": "female",
"preview_url": "https://api.tts.ai/v1/voices/preview/af_bella.mp3"
}
],
"total": 142
}
Ënnertitelen (SRT / VTT) nei
Generéiert synchroniséiert Ënnertitelen fir all ofgeschlossen TTS-Aufgaben. Féiert Whisper-Ausrichtung iwwer den Audio aus an gëtt SRT oder WebVTT zréck. D'Resultat gëtt op der Disk gecached, sou datt en zweete Aufruff fir déi selwecht UID eng Disk-Lies ass.
Parameter
| Parameter | Erfuerderlech | Beschreiwung |
|---|---|---|
| uuid | Ja | D'Spill ass op der Konsol PlayStation 1 an op der Konsol PlayStation 2 erauskomm. |
| format | Nee | D'Code-Sprooche sinn: C++ (Code-Sprooch) C# (Code-Sprooch) |
| download | Nee | 1 to send Content-Disposition: attachment so the browser saves rather than displays. |
| language | Nee | D'Aarbechtszäit ass op d'Aarbechtszäit (oder op d'Aarbechtszäiten) limitéiert. |
curl "https://api.tts.ai/v1/speech/subtitles/?uuid=$UUID&format=srt&download=1" -o subtitles.srt
Aussprooch-Wëssenschaft nei
De TTS-Motor informéieren, wéi een e bestëmmte Wuert ausschwätzt. Gespäichert Einträge ginn automatesch op all TTS-Ufro applizéiert, déi Dir maacht. Limit fir 200 Einträge pro Kont.
Ufrokörper (POST)
| Parameter | Typ | Beschreiwung |
|---|---|---|
| word | string | Wuert fir ze iwwerschreiwen (z.B. GIF, Anthropic). Wuertgrenz passt. |
| replacement | string | D'Code-Sprooche sinn: C++ (Code-Sprooch), C# (Code-Sprooch), Java (Code-Sprooch), Perl (Code-Sprooch). |
| language | string | Optiounen ISO Code. Leer = gëllt fir all Sproochen. |
| case_sensitive | boolean | Standard false. Passt d'Grouss-/Kleeschteschrëft genau un wann true. |
# Save an entry
curl -X POST https://tts.ai/api/v1/pronunciations/ \
-H "Authorization: Bearer sk-tts-..." \
-H "Content-Type: application/json" \
-d '{"word": "GIF", "replacement": "jiff"}'
# List your entries
curl https://tts.ai/api/v1/pronunciations/ -H "Authorization: Bearer sk-tts-..."
# Delete entry by id
curl -X DELETE "https://tts.ai/api/v1/pronunciations/?id=42" -H "Authorization: Bearer sk-tts-..."
Et kann een och d'Resultat vun enger Reaktioun mat engem anere Reaktiounsprodukt (z. B. mat engem anere Reaktiounsprodukt vun der Reaktioun) vergläichen.
Artikel-Sprecher nei
D'Sprooch ass eng vun de wichtegsten a wichtegsten Sproochen an der Welt, an et gëtt eng ganz Rei vu Sproochen, déi op der ganzer Welt geschwat ginn, an déi allgemeng als Sprooche vun der Welt ugesinn ginn.
<script src="https://tts.ai/narrator.js"
data-pk="pk-tts-your-publishable-key"
data-voice="af_bella"
data-model="kokoro"
data-extract="auto"
data-position="bottom"
data-color="#e60000"
data-locale="en"></script>
Optiounen
| Parameter | Beschreiwung |
|---|---|
data-pk | Publizéierbare Schlëssel (pk-tts-…). Domänenrestriktioune ginn iwwer d'Feld allowed_domains vum Schlëssel erfuerdert. |
data-voice | D'Sprooch ass d'Sprooch vum "Sprache"-Begriff. |
data-model | D'Code-Nummer ass d'Nummer vun der Code-Säit. |
data-extract | auto (Standard) — probéiert article/main/.post-content/.entry-content Selektoren, fällt zréck op déi dichtst Absatz Cluster. Oder gitt all CSS Selektor fir e spezifescht Element ze zielen. |
data-position | D'Code-Sprooche sinn: C++ (Code-Sprooch) C# (Code-Sprooch) |
data-color | Akzentfaarf (egal wéi eng CSS-Faarf). Standard #e60000. |
data-min-chars / data-max-chars | Iwwersprécht d'Sträif wann den Artikel méi kuerz ass wéi min- Zeichen (Standard 200). Cap Input op max- Zeichen (Standard 50. 000). |
D'Grenz ass d'A-Linn (A-Linn).
Widget fir d'Héieren-Knäppchen
Inline Button-style embed. Renders next to its tag and plays a button-triggered short snippet. Different shape from the Article Narrator above (which automatically-injects a page-spanning bar and narrates the entire article).
<script src="https://tts.ai/widget.js"
data-voice="af_bella"
data-model="kokoro"
data-style="full"
data-theme="light"></script>
Gespaarte Stëmmen (persistent Klonen)
Referenz-Audio eemol erofladen, eng persistente voice_id kréien, an dann op déi Id in TTS-Ufroen referenzéiert, anstatt den Audio bei all Anruf erofzelueden. Ideal fir Integratiounen mat vill Volumen.
Stëmm erofladen
POST
https://tts.ai/api/v1/user-voices/
Authentifikatioun erfuerderlech
Felder: Datei (erfuerderlech, 5-30s Audio), Numm (erfuerderlech), Sprooch (optional, standard en), Modell (optional — wielt automatesch cosyvoice2 fir zh/ja/ko anerersäits openvoice), consent_confirmed (erfuerderlech, all true Wäert).
curl -X POST https://tts.ai/api/v1/user-voices/ \
-H "Authorization: Bearer sk-tts-your-key" \
-F "file=@reference.wav" \
-F "name=My Narrator" \
-F "language=en" \
-F "consent_confirmed=true"
# Response:
{
"public_id": "uv_a1b2c3d4e5f6",
"id": 42,
"name": "My Narrator",
"model_name": "openvoice",
"language": "en",
"reference_audio_url": "https://tts.ai/media/user-voices/....wav",
"storage_status": "active",
"created_at": "2026-04-17T03:45:00+00:00"
}
D'gespäichert Stëmm am TTS benotzen
POST to /api/v1/tts/ (NOTE: web VPS host, not api.tts.ai) with user_voice_id. We load your stored audio and route to the cloning pipeline.
curl -X POST https://tts.ai/api/v1/tts/ \
-H "Authorization: Bearer sk-tts-your-key" \
-H "Content-Type: application/json" \
-d '{"text":"Hello from my saved voice","user_voice_id":"uv_a1b2c3d4e5f6"}'
# Returns a queued job — poll /v1/speech/results/?uuid=... for the audio URL.
Lëscht / Läschen
GET https://tts.ai/api/v1/user-voices/ # list your saved voices + quota info
DELETE https://tts.ai/api/v1/user-voices/?public_id=uv_a1b2c3d4e5f6
Archivéieren / Reaktivéieren (fräi)
Archivéiert Stimmen bleiwen an Ärem Kont, mä kënnen net an TTS benotzt ginn. Nützlech fir d'Endanwender déi net aktiv sinn, fir datt Är Lëscht sauber bleift.
POST https://tts.ai/api/v1/user-voices/uv_a1b2c3d4e5f6/archive/
POST https://tts.ai/api/v1/user-voices/uv_a1b2c3d4e5f6/reactivate/
Code Beispiller
Text- op- Sprooch
import requests
API_KEY = "sk-tts-your-key"
# Text to Speech
response = requests.post(
"https://api.tts.ai/v1/tts/",
headers={"Authorization": f"Bearer {API_KEY}"},
json={
"model": "kokoro",
"text": "Hello from TTS.ai!",
"voice": "af_bella",
"format": "mp3"
}
)
with open("output.mp3", "wb") as f:
f.write(response.content)
print(f"Credits used: {response.headers.get('X-Credits-Used')}")
Sprooch op Text
# Speech to Text
with open("recording.mp3", "rb") as f:
response = requests.post(
"https://api.tts.ai/v1/stt/",
headers={"Authorization": f"Bearer {API_KEY}"},
files={"file": f},
data={"model": "faster-whisper", "timestamps": "true"}
)
result = response.json()
print(result["text"])
Stëmmklonung
# Voice Cloning
with open("reference.wav", "rb") as ref:
response = requests.post(
"https://api.tts.ai/v1/tts/clone/",
headers={"Authorization": f"Bearer {API_KEY}"},
files={"reference_audio": ref},
data={
"text": "This speech uses a cloned voice.",
"model": "chatterbox"
}
)
with open("cloned_output.mp3", "wb") as f:
f.write(response.content)
Text- op- Sprooch
const API_KEY = 'sk-tts-your-key';
// Text to Speech
const response = await fetch('https://api.tts.ai/v1/tts/', {
method: 'POST',
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'kokoro',
text: 'Hello from TTS.ai!',
voice: 'af_bella',
format: 'mp3'
})
});
const audioBlob = await response.blob();
const audioUrl = URL.createObjectURL(audioBlob);
const audio = new Audio(audioUrl);
audio.play();
Sprooch op Text
// Speech to Text
const formData = new FormData();
formData.append('file', audioFile);
formData.append('model', 'faster-whisper');
const response = await fetch('https://api.tts.ai/v1/stt/', {
method: 'POST',
headers: { 'Authorization': `Bearer ${API_KEY}` },
body: formData
});
const result = await response.json();
console.log(result.text);
Text- op- Sprooch
# Text to Speech
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!","voice":"af_bella","format":"mp3"}' \
-o output.mp3
Sprooch op Text
# Speech to Text
curl -X POST https://api.tts.ai/v1/stt/ \
-H "Authorization: Bearer sk-tts-your-key" \
-F "file=@recording.mp3" \
-F "model=faster-whisper" \
-F "timestamps=true"
Stëmmklonung
# Voice Cloning
curl -X POST https://api.tts.ai/v1/tts/clone/ \
-H "Authorization: Bearer sk-tts-your-key" \
-F "reference_audio=@reference.wav" \
-F "text=This uses a cloned voice." \
-F "model=chatterbox" \
-o cloned.mp3
Audioverbesserung
# Audio Enhancement
curl -X POST https://api.tts.ai/v1/audio/enhance/ \
-H "Authorization: Bearer sk-tts-your-key" \
-F "file=@noisy_audio.mp3" \
-F "denoise=true" \
-F "enhance_clarity=true" \
-o enhanced.mp3
Fehlercodes
All Feeler ginn eng JSON-Antwort mat engem error Feld.
{
"error": {
"code": "insufficient_credits",
"message": "You do not have enough characters for this request.",
"characters_required": 4000,
"characters_available": 2000
}
}
| HTTP Status | Fehlercode | Beschreiwung |
|---|---|---|
| 400 | bad_request |
Ongülteg Ufroparameter. Kuckt d' Feelermeldung fir Detailer. |
| 401 | unauthorized |
Fëllenden oder ongültege API Schlëssel. |
| 402 | insufficient_credits |
Net genuch Kreditter. Kaaft méi bei /pricing/. |
| 403 | forbidden |
Dir hutt net d'Recht op dës Ressource ze zougräifen (z. B. fir den Job vun engem aneren Notzer ze froen). Den API-Zugang selwer ass an all Plang abegraff. |
| 404 | not_found |
Modell oder Stëmm net fonnt. |
| 413 | file_too_large |
Déi erofgeladen Datei iwwerschreift d'Gréisstlimit. |
| 429 | rate_limited |
Zu vill Ufroen. Iwwerpréift d' Kopfzeilen mat der Geschwindegkeetsbegrenzung. |
| 500 | internal_error |
Serverfehler. Probéiert et méi spéit nach eng Kéier. |
| 503 | model_loading |
Modell gëtt geladen. Probéiert et an e puer Sekonnen erëm. |
Webhooks
Fir laang lafend Aufgaben (Stem Splitting, Batch TTS), kënnt Dir e webhook_url Parameter uginn. Wann d'Aufgab fäerdeg ass, wäerte mir d'Resultat un Är URL POST maachen.
{
"event": "task.completed",
"task_id": "task_abc123",
"status": "success",
"result_url": "https://api.tts.ai/v1/results/task_abc123",
"credits_used": 12,
"created_at": "2025-01-15T10:30:00Z",
"completed_at": "2025-01-15T10:30:45Z"
}
Bereet ze bauen?
Gitt Ären API Schlëssel a fänkt un TTS.ai an Är Applikatiounen ze integréieren.