Ukufaka idokhumende
I-TTS.ai ixhunywe kumasevisi akho nge-REST API yethu. Ifomethi ehambisana ne-OpenAI yokufuduka okulula.
Umbono
I-TTS.ai API inikeza ukufinyelela kwe-programmic kuzo zonke izici ze-platform: ukudweba kwe-text-to-speech, ukudweba kwe-speech-to-text, ukuklonya kwezwi, ukuphuculwa kwe-audio, nokunye okuningi. I-API isebenzisa izivumelwano ze-REST ezijwayelekile nge-JSON request/response bodies.
Isithonjana se-API
Thola isithonjana sakho se-API kusuka Izilungiselelo ze-akhawunti. Kutholakala ku-Pro ne-Enterprise plans.
Isisekelo se-URL
https://api.tts.ai/v1/
Ukugunyazwa
I-bearer token nge Authorization okuphezulu
Ukuqinisekiswa
/v1/tts/ kusebenza ngaphandle kwe-auth, kuze kube ngu-5,000 amaphawu/izinsuku nge-IP, usebenzisa noma iyiphi yemodeli yethu emahhala (piper, vits, melotts, kokoro). Bhala i-akhawunti emahhala ukuze uthole ama-15,000 ama-bonus characters kanye nokungena kumamodeli aphezulu.
Imodeli ye-premium nemikhawulo yezinga eliphakeme, qinisekisa nge-Bearer token ku Authorization okuphezulu.
Authorization: Bearer sk-tts-your-api-key-here
I-SDKs
I-SDK esemthethweni ikwenza kube lula ukuxhuma i-TTS.ai kusicelo sakho. Zonke zivulekile futhi zitholakala ku-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');
Isisekelo se-URL
Zonke iziqongo zihlobene nale-URL eyinhloko. Umzekelo, isiqongo se-TTS siwu:
Amaphesenti
Imingcele yesilinganiso se-API ihluka ngokwe-plan:
| I-Plan | Izicelo/imini | I-Concurrent | Ubude obuphezulu bombhalo |
|---|---|---|---|
| Ikhululekile | 10 | 2 | Amaphawu angama-500 |
| Isiqalisi | 30 | 3 | 1,000,000 characters |
| I-Pro | 60 | 5 | 1,000,000 characters |
| Ibhizinisi | 300 | 20 | 50,000 characters |
Isihloko somkhawulo wezinga siqukiwe kuwo wonke umlayezo: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
Izindleko zekhedi
| Izinsizakalo | Izindleko | Iyunithi |
|---|---|---|
| TTS (Amamodeli amahhala: Piper, VITS, MeloTTS) | 1,000 characters | ngamagama angama-1,000 |
| TTS (Amamodeli ajwayelekile: Kokoro, CosyVoice 2, njll.) | 2,000 amaphawu | ngamagama angama-1,000 |
| TTS (Amamodeli aphezulu: Tortoise, Chatterbox, njll.) | 4,000 amaphawu | ngamagama angama-1,000 |
| Ukukhuluma kuMbhalo | 2,000 amaphawu | ihora ngalinye lomsindo |
| Ukulungiswa kwezwi | 4,000 amaphawu | ngamagama angama-1,000 |
| Umshintshi womsindo | 3,000 amaphawu | ihora ngalinye lomsindo |
| Ukuthuthukiswa komsindo | 2,000 amaphawu | ihora ngalinye lomsindo |
| Ukususa umsindo / Ukuhlukanisa umsindo | 3,000-4,000 characters | ihora ngalinye lomsindo |
| Ukuhumusha kwezwi | 5,000 amaphawu | ihora ngalinye lomsindo |
| Izingxoxo zomsindo | 3,000 amaphawu | nge-turn |
| Iqhosha le-BPM Finder | Ikhululekile | -- |
| Umguquli womsindo | Ikhululekile | -- |
Umbhalo usuka kumazwi
Guqula umbhalo ube umsindo wokukhuluma. Ibuyisela ihele lomsindo ngefomethi ecelwe.
Isiqu sesicelo
| Amapharamitha | Uhlobo | Kudingeka | Incazelo |
|---|---|---|---|
| model | string | Akukho | Imodeli ID (isibonelo, kokoro, chatterbox, piper). Uma ilahlekile, sizokhetha ngokuzenzakalela imodeli exhasa i language ecelwe — kokoro ye-en/ja/zh/ko/fr/de/it/pt/es/hi/ru, piper yezinye izilimi ezixhasiwe (ar/pl/nl/cs/da/fi/el/hu/tr/uk/vi/etc.). |
| text | string | Yebo | Umbhalo oguqulwe ube ulwimi. Isicelo ngasinye sifinyelela: 500 amaphawu (angaziwayo), 5,000 (i-akhawunti emahhala), 1,000,000 (i-akhawunti ekhokhelwayo). Izingeniso ezide zihlukaniswa ngokuzenzakalela ngakwesokudla somhlinzeki. |
| voice | string | Yebo | Umsindo ID (sebenzisa /v1/voices/ ukudweba umsindo okhona) |
| format | string | Akukho | Ifomethi yesingeniso: mp3 (iphutha), wav, flac, ogg
|
| speed | float | Akukho | Uku multiplier isivinini sokukhuluma. Okuzenzakalelayo: 1.0. Uluhlu: 0.5 kuya ku 2.0 |
| language | string | Akukho | Umbhalo ofingqiwe wesilimi (isibonelo, en, es). Uzotholakala ngokuzenzakalela uma ushiyekile. |
| instructions | string | Akukho | Ukuphatha / ukuthunyelwa kwe-cues (≤500 chars). eg. \ |
| pronunciations | object | array | Akukho | Ubizo-lucela ukumiswa. Noma {\ |
| stream | boolean | Akukho | Vumela umlayezo wokusakaza. Okuzenzakalelayo: false |
Isibonelo sezicelo
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
Amathegi we-SSML
Inombolo yokufaka, usuku, imali, inani lefoni, kanye negama elincane Uhlobo lwemininingwane yemininingwane yemininingwane 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
chaza Isingeniso Ikhuluma njenge cardinal1234one thousand two hundred thirty-four ordinal21twenty-first date1999-12-31December thirty-first, nineteen ninety-nine 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 ngesiNgisi no dmy kwezinye izindawo; cindezela nge 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."
}Umlayezo
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.Full example
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.
Ukukhuluma kuMbhalo
Gcwalisa umsindo ube ngumbhalo. Ixhasa izilimi ezingu-99 nge-auto-detection.
Isiqu sesicelo (multipart/form-data)
| Amapharamitha | Uhlobo | Kudingeka | Incazelo |
|---|---|---|---|
| file | file | Yebo | Ihele lomsindo (MP3, WAV, FLAC, OGG, M4A, MP4, WebM). Max 100MB. |
| model | string | Akukho | Imodeli ye-STT: whisper (iphutha), faster-whisper, sensevoice
|
| language | string | Akukho | Umbhalo ofingqiwe wesilimi. auto ukuhlola okuzenzakalelayo (okuzenzakalelayo). |
| timestamps | boolean | Akukho | Kuhlanganise negama-level timestamps. Okuzenzakalelayo: false |
| diarize | boolean | Akukho | Vumela isiqophi somsindo. Okuzenzakalelayo: false |
Umlayezo
{
"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"
}
]
}
Ukulungiswa kwezwi
Yenza umlayezo ngezwi elilodwa. Layisha phezulu umlayezo we-audio ne-text.
Isiqu sesicelo (multipart/form-data)
| Amapharamitha | Uhlobo | Kudingeka | Incazelo |
|---|---|---|---|
| reference_audio | file | Yebo | Ucingo lomsindo wokubonisa (imizuzu engu-10-30 ivunyelwe). Ubuningi 20MB. |
| text | string | Yebo | Umbhalo okhuluma ngesibizo esiklonyelelwe. |
| model | string | Akukho | Imodeli ye-clone: chatterbox (iphutha), cosyvoice2, gpt-sovits
|
| format | string | Akukho | Ifomethi yesingeniso: mp3 (iphutha), wav, flac
|
| language | string | Akukho | Ikhowudi yesilimi esithenjwa. Kudingeka ixhaswe yimodeli ekhethiwe. |
Umlayezo
Ibuyisela ihele lomsindo njengedatha ye-binary, efanayo ne-TTS endpoint.
Umshintshi womsindo
Guqula umsindo ube yizwi elihlukile. Layisha umsindo womsuka bese ukhetha umsindo ofuna ukuwuthola.
Isiqu sesicelo (multipart/form-data)
| Amapharamitha | Uhlobo | Kudingeka | Incazelo |
|---|---|---|---|
| file | file | Yebo | Umsuka wehele lomsindo (MP3, WAV, FLAC). Ubuningi 50MB. |
| target_voice | string | Yebo | I-ID yomsindo ofuna ukuwuguqula (sebenzisa /v1/voices/ ukudweba imisindo ekhona) |
| model | string | Akukho | Imodeli yokuguqulwa kwezwi: openvoice (iphutha), knn-vc
|
| format | string | Akukho | Ifomethi yokuphuma: wav (iphutha), mp3, flac
|
Isibonelo sezicelo
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
Umlayezo
Ibuyisela ihele lomsindo eliguqulwe njengedatha ye-binary.
Ukuhumusha kwezwi
Guqula umsindo okhulumayo kusuka kulesilimi kuye kwesinye. Ihlanganisa ukukhuluma-nokubhala, ukuhumusha, nokubhala-nokukhuluma kunoma yini eyodwa.
Isiqu sesicelo (multipart/form-data)
| Amapharamitha | Uhlobo | Kudingeka | Incazelo |
|---|---|---|---|
| file | file | Yebo | Ihele lomsindo lomsuka ngesilimi sakuqala. Ubude obuphezulu 100MB. |
| target_language | string | Yebo | Umbhalo ofingqiwe wesizinda solimi (isibonelo, es, fr, de, ja) |
| voice | string | Akukho | Umsindo we-output eguqulwe. Ikhethiwe ngokuzenzakalela uma ihlehliswa. |
| preserve_voice | boolean | Akukho | Zama ukugcina izimo zoเสียงe zomsindo omusha. Iphutha: false |
Umlayezo
{
"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
}
Ukukhuluma ku-Ukukhuluma
Guqula indlela yokukhuluma, inkulumo, noma ukuthunyelwa ngenkathi ugcina okuqukethwe. Kusetshenziswa ukuhlela umsindo, ukukhawulela, nokuveza.
Isiqu sesicelo (multipart/form-data)
| Amapharamitha | Uhlobo | Kudingeka | Incazelo |
|---|---|---|---|
| file | file | Yebo | Umthombo wehele lomsindo lomsindo. Max 50MB. |
| voice | string | Yebo | I-ID yomsindo ofuna ukuwuthola ku-output speech |
| model | string | Akukho | Imodeli: openvoice (iphutha), chatterbox
|
| emotion | string | Akukho | Inhloso yomqondo: neutral, happy, sad, angry, excited
|
| speed | float | Akukho | Ukuhlela isivinini. Okuzenzakalelayo: 1.0. Uluhlu: 0.5 kuya ku 2.0
|
Umlayezo
Ibuyisela ihele lomsindo eliguqulwe njengedatha ye-binary.
Amathuluzi omsindo
Izinhlamvu zokuphatha umsindo zokuthuthukisa, ukususa umsindo, ukuhlukaniswa kwe-stem, njll.
Nciphisa ukhwalithi yomsindo: khulula umsindo, thuthukisa ukucacile, sinqumo esiphezulu.
| file file | Ihele lomsindo okufanele lithuthukiswe |
| denoise boolean | Vumela i-denoise (iphutha: yiqiniso) |
| enhance_clarity boolean | Nciphisa ukucacile kokukhuluma (iphutha: yiqiniso) |
| super_resolution boolean | Izinga lomgangatho womsindo (okungajwayelekile: akulungile) |
| strength integer | 1-3 (ekhanyayo, ephakathi, enamandla). Okuzenzakalelayo: 2 |
Yakha izingoma eziphuma ezisetshenziswani (ukususa izingoma) noma uhlukanise zibe izihlahla.
| file file | Ihele lomsindo ofuna ukulihlukanisa |
| model string | demucs (iphutha) noma spleeter |
| stems integer | Inani lezinhlamvu: 2, 4, 5, noma 6 (isimiso: 2) |
| format string | Ifomethi yesingeniso: wav, mp3, flac |
Susa i-echo ne-reverb kusuka ku-audio recordings.
| file file | Ihele lomsindo olungenziwa |
| type string | echo or reverb (default: both) |
| intensity integer | 1-5 (default: 3) |
Hlola umsindo ukuze ubone isithonjana, i-BPM, kanye nesikhathi sokufaka isitifiketi.
| file file | Ihele lomsindo ofuna ukulihlolisa |
{
"key": "C",
"scale": "Major",
"bpm": 120.0,
"time_signature": "4/4",
"camelot": "8B",
"compatible_keys": ["C Major", "G Major", "F Major", "A Minor"]
}
Guqula umsindo phakathi kwefomethi.
| file file | Ihele lomsindo ofuna ukuliguqula |
| format string | Ifomethi efanele: mp3, wav, flac, ogg, m4a, aac |
| bitrate integer | I-bitrate yesikhishwayo ku-kbps: 64, 128, 192, 256, 320 |
| sample_rate integer | Isibalo sesampula: 22050, 44100, 48000 |
| channels string | mono noma stereo |
Izingxoxo zomsindo
Thumela umsindo noma umbhalo bese uthola umlayezo we-AI ngezwi elihlanganisiwe.
Isiqu sesicelo (multipart/form-data noma JSON)
| Amapharamitha | Uhlobo | Kudingeka | Incazelo |
|---|---|---|---|
| audio | file | Akukho* | Isingeniso somsindo (noma audio noma text kudingeka) |
| text | string | Akukho* | Isingeniso sombhalo (noma audio noma text kudingeka) |
| voice | string | Akukho | Umsindo wokuphendula kwe-AI. Okuzenzakalelayo: af_bella |
| tts_model | string | Akukho | Imodeli ye-TTS yokuphendula. Okuzenzakalelayo: kokoro |
| system_prompt | string | Akukho | Isimo esizenzakalelayo sombuzo we-AI |
| conversation_id | string | Akukho | Qhubeka nezingxoxo ezikhona |
Umlayezo
{
"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
}
I-TTS ye-batch
Sithumela imibhalo eminingi yokuzaliseka kwe-TTS. Uma ufuna, thola umlayezo we-webhook uma zonke imisebenzi iqediwe.
Amapharamitha
| Amapharamitha | Uhlobo | Incazelo |
|---|---|---|
| texts | array | Array of objects: {text, model, voice}. Max 50 items. |
| webhook_url | string | Optional URL to POST results when batch completes. |
Umlayezo
{
"batch_id": "abc123",
"total": 3,
"completed": 0,
"status": "processing"
}
Uqhubekeko lwe-poll nge-GET /v1/tts/batch/result/?batch_id=abc123
Ukungenisa umsindo
Ibala ngaphambi kokufaka umsindo kusuka ku-reference audio. Sebenzisa i-embed_id ebuyiselwe ku-requests ye-cloning yomsindo olandelayo ukudala okunokwenzeka.
Amapharamitha
| Amapharamitha | Uhlobo | Incazelo |
|---|---|---|
| file | file | Reference audio file (WAV, MP3, FLAC). |
| model | string | Cloning model (default: chatterbox). Supported: chatterbox, cosyvoice2, openvoice, gpt-sovits, spark, indextts2, qwen3-tts. |
Umlayezo
{
"embed_id": "emb_abc123",
"model": "chatterbox",
"duration_ms": 450
}
Ukuhlolwa kwempilo
Khangela isimo somhlinzeki we-GPU, amamodeli alayishiwe, kanye nobukhulu befolo. Akukho bufakazi obudingekayo. Kugcinwe isikhathi samasekondi angama-30.
Umlayezo
{
"status": "online",
"latency_ms": 45,
"queue_size": 3,
"models_loaded": ["kokoro", "chatterbox", "cosyvoice2"]
}
Hlela amamodeli
Ibuyisela uhlu lwawo wonke amamodeli atholakalayo nekhono labo.
Umlayezo
{
"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
}
]
}
Uhlu lwamagama
Ibuyisela uhlu lwazo zonke izizwi ezikhona, ezihlanganisiwe ngemodeli noma ulwimi.
Ipharamitha yombuzo
| Amapharamitha | Uhlobo | Incazelo |
|---|---|---|
| model | string | Isihlungi ngemodeli ID (e.g., kokoro) |
| language | string | Isihlungi ngekhodi yesilimi (isibonelo, en) |
| gender | string | Isihlungi ngokwesondo: male, female, neutral
|
Umlayezo
{
"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
}
Izihloko ezingezansi (SRT / VTT) entsha
Dala izihloko ezihambisanayo nganoma iyiphi imisebenzi ye-TTS eqediwe. Iqhuba ukulinganisa kwe-Whisper phezu kwesandi futhi ibuyisela i-SRT noma i-WebVTT. Imiphumela igcinwa endaweni yokufihla kwidiski ukuze umlayezo wesithathu we-uuid efanayo ube yidiski yokufundwa.
Ipharamitha yombuzo
| Amapharamitha | Kudingeka | Incazelo |
|---|---|---|
| uuid | Yebo | Imisebenzi UUID ebuyiselwe ngu /v1/tts/ noma /v1/voice-clone/. |
| format | Akukho | srt (iphutha) noma vtt. |
| download | Akukho | 1 ukuthumela Isihloko-Uhlelo: isifaki ukuze isiphequluli sigcine endaweni yokukhombisa. |
| language | Akukho | Usizo lwemodeli yokulinganisa (itholakale ngokuzenzakalela uma ilahlekile). |
curl "https://api.tts.ai/v1/speech/subtitles/?uuid=$UUID&format=srt&download=1" -o subtitles.srt
Incwadi yegama entsha
Ukhuluma kanjani ngenjini ye-TTS. Izingeniso ezigcinwe zisetshenziswa ngokuzenzakalela kunoma yisiphi isicelo se-TTS osenza. Ukungena kwe-200 kungakapheli i-akhawunti ngayinye.
Isiqu sesicelo (POST)
| Amapharamitha | Uhlobo | Incazelo |
|---|---|---|
| word | string | Igama elizodlula (isibonelo GIF, Anthropic). Umkhawulo wegama ufana. |
| replacement | string | Indlela yokuyibhala ngemodeli (isibonelo jiff, ann THROP ick). |
| language | string | Ikhowudi ye-ISO ekhethiwe. Engenanto = isebenza kuwo wonke amagama. |
| case_sensitive | boolean | Iphutha ubuxoki. Uhlobo lwegama lufana ngokugcwele uma yinyani. |
# 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-..."
Ungadlulisa futhi izicelo ezingaphezu kwezinga-1 ngaphandle kokuzigcina — hlanganisa izinhlamvu nganoma iyiphi /v1/tts/ inkulumo njengento noma i-array (bona i-TTS endpoint params).
Umbhali wesihloko entsha
Lahla i- tag eyodwa kunoma iyiphi ikhasi lesihloko futhi abavakashi bathola umfundi oqinile okhuluma ikhasi uma ucofoza. Ithola ngokuzenzakalela isiqu sesihloko, isekela umsindo / imodeli / indawo / umbala we-accent.
<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>
Izinketho
| Amapharamitha | Incazelo |
|---|---|
data-pk | Isitshixo esishicilelwe (pk-tts-...). Izinqwaba zendawo ezigunyaziwe nge allowed_domains isizinda sesitshixo. |
data-voice | Umsindo ID. af_bella ozenzakalelayo. |
data-model | Imodeli ye-TTS ID. Iphutha ikhodi. |
data-extract | auto (iphutha) — izama isihloko/isihloko/.post-content/.entry-content abakhethi, ibuyela emuva kwisigaba esiqinile. Noma udlulise noma yimuphi umkhethi we-CSS ukukhomba isici esikhethekile. |
data-position | bottom (iphutha) noma top. |
data-color | Umbala wesimo (noma yimuphi umbala we-CSS). Okuzenzakalelayo #e60000. |
data-min-chars / data-max-chars | Lahla ibha uma incwadi incane kunezinhlamvu ezincane (iphutha 200). Cisha isingeniso kuzinhlamvu eziphezulu (iphutha 50,000). |
Isithonjana Sokuzilalela
Isitayela sezinkinobho ezingaphakathi-line. Zibonisa eduze kwe tag futhi zidlala inkinobho eqhutshwa isiqephu esincane. Isimo esihlukile ku-Article Narrator ngasentla (efaka ngokuzenzakalela ikhasi-elingabambisana nebha futhi ikhuluma ngesihloko sonke).
<script src="https://tts.ai/widget.js"
data-voice="af_bella"
data-model="kokoro"
data-style="full"
data-theme="light"></script>
Izizwi ezigcinwe (Iziklone Eziqhubekayo)
Layisha phezulu umsindo obhekiswe kuwo kabili, uthola umsindo_id oqhubekayo, bese ubhekisa kulowo id ku-TTS izicelo endaweni yokulayisha kabusha umsindo nganoma yisiphi isikhalazo. Ilungele ukuxhuma okuphezulu kwevolumu.
Faka umsindo
POST
https://tts.ai/api/v1/user-voices/
Ubufakazi budingeka
Ifomu eliningi. Amabhokisi: ifayela (elidingekayo, 5-30s umsindo), igama (elidingekayo), ulwimi (okukhethwa kukho, okuzenzakalelayo en), imodeli (okukhethwa kukho — ikhetha ngokuzenzakalela i-cosyvoice2 ye zh/ja/ko noma i-openvoice), consent_confirmed (elidingekayo, noma yiliphi inani elilungile).
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"
}
Sebenzisa umsindo ogcinwe ku-TTS
POST ku /api/v1/tts/ (NOMA: i-web VPS host, hhayi api.tts.ai) nge user_voice_id. Sifaka umsindo wakho ogcinwe futhi siyibeke indlela ku-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.
Hlela / Cisha
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
Ihele / yenza kabusha (mahhala)
Amazwi agcinwe encwadini zihlala kwi-akhawunti yakho kodwa azisebenzi ku-TTS. Kuhle kubasebenzisi abafileyo besikhathi sokuphela ukuze uhlu lwakho luhlale luhlanzekile.
POST https://tts.ai/api/v1/user-voices/uv_a1b2c3d4e5f6/archive/
POST https://tts.ai/api/v1/user-voices/uv_a1b2c3d4e5f6/reactivate/
Isibonelo sekhodi
Umbhalo usuka kumazwi
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')}")
Ukukhuluma kuMbhalo
# 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"])
Ukulungiswa kwezwi
# 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)
Umbhalo usuka kumazwi
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();
Ukukhuluma kuMbhalo
// 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);
Umbhalo usuka kumazwi
# 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
Ukukhuluma kuMbhalo
# 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"
Ukulungiswa kwezwi
# 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
Ukuthuthukiswa komsindo
# 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
Amakhodi wephutha
Zonke izinkinga zibuyisela umlayezo we-JSON one- error isigaba.
{
"error": {
"code": "insufficient_credits",
"message": "You do not have enough characters for this request.",
"characters_required": 4000,
"characters_available": 2000
}
}
| Isimo se HTTP | Iphutha lekhowudi | Incazelo |
|---|---|---|
| 400 | bad_request |
Izinkomba zombuzo ezingasebenzi. Khangela umlayezo wephutha ngezinhlamvu. |
| 401 | unauthorized |
Isithonjana se-API esilahlekile noma esingasebenzi. |
| 402 | insufficient_credits |
Akunamagama aphelele. Thenga ngaphezu kwalokhu ku /pricing/. |
| 403 | forbidden |
Awunazo izinqumo zokufinyelela kulendawo yokugcina (isibonelo, ukuvota umsebenzi wesisebenzisi esisodwa). Ukufinyelela kwe-API kufakwe kunoma iyiphi i-plan. |
| 404 | not_found |
Imodeli noma umsindo awutholakali. |
| 413 | file_too_large |
Ihele elilayishiwe lidlula umkhawulo wobukhulu. |
| 429 | rate_limited |
Izicelo eziningi kakhulu. Khangela umkhawulo wezinga lokubhalwe emantla ephepha. |
| 500 | internal_error |
Iphutha lesisebenzisi. Zama futhi kamuva. |
| 503 | model_loading |
Imodeli ifaka. Zama futhi ngemuva kwemizuzu embalwa. |
I-Webhooks
Imisebenzi esebenza isikhathi eside (ukuhlukaniswa kwe-stem, i-batch TTS), unganikeza i webhook_url parameter. Xa umsebenzi uqediwe, sizo-POST imiphumela ku-URL yakho.
{
"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"
}
Ukulungele ukuhlela?
Thola isithonjana sakho se-API bese uqala ukuxhuma i-TTS.ai kumasevisi akho.