Doiciméadú API
Comhtháthú TTS.ai i do chuid iarratais lenár REST API. OpenAI-comhoiriúnach formáid le haghaidh imirce éasca.
Forbhreathnú
Soláthraíonn an API TTS.ai rochtain ríomhchláraithe ar gach gné den ardán: sintéis téacs-go-urlabhra, trascríobh ó chaint go téacs, clónáil gutha, feabhsú fuaime, agus níos mó.Baineann an API úsáid as coinbhinsiúin chaighdeánacha REST le comhlachtaí iarratais / freagartha JSON.
Eochair API
Faigh d'eochair API ó Socruithe Cuntais. Ar fáil ar phleananna Pro agus Fiontair.
URL Bunúsach
https://api.tts.ai/v1/
Údarú
Comhartha iompróra trí Authorization ceanntásc
Fíordheimhniú
/v1/tts/ obair gan aon auth, suas le 5,000 carachtair / lá in aghaidh an IP, ag baint úsáide as aon cheann dár samhlacha saor in aisce (piper, vits, melotts, kokoro). Cláraigh le haghaidh cuntas saor in aisce a fháil 15,000 carachtair bónas agus rochtain ar samhlacha préimhe.
Éilíonn gach iarratas API fíordheimhniú trí chomhartha Bearer sa Authorization ceanntásc.
Authorization: Bearer sk-tts-your-api-key-here
SDKanna
Tá SDKanna oifigiúla ann a éascaíonn TTS.ai a chomhtháthú i d’iarratas.Tá an dá cheann acu foinse oscailte agus ar fáil ar 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');
URL Bunúsach
Tá gach críochphointe coibhneasta leis an mbonn- URL seo. Mar shampla, is é seo an críochphointe TTS:
Teorainneacha Ráta
Athraíonn teorainneacha ráta API de réir plean:
| Plean | Iarratais/ nóiméad | Comhuaineach | Fad Uasta Téacs |
|---|---|---|---|
| Saor | 10 | 2 | 500 carachtar |
| Tosaitheoir | 30 | 3 | 1,000,000 carachtar |
| Pro | 60 | 5 | 1,000,000 carachtar |
| Fiontraíocht | 300 | 20 | 50,000 carachtar |
Tá ceannteidil teorainn ráta san áireamh i ngach freagra: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
Costais Chreidmheasa
| Seirbhís | Costas | Aonad |
|---|---|---|
| TTS (samhlacha saor in aisce: Piper, VITS, MeloTTS) | 1 chreidmheas | in aghaidh 1, 000 carachtar |
| TTS (samhlacha caighdeánacha: Kokoro, CosyVoice 2, etc.) | 2 creidmheasanna | in aghaidh 1, 000 carachtar |
| TTS (samhlacha Préimhe: Tortoise, Chatterbox, etc.) | 4 creidmheasanna | in aghaidh 1, 000 carachtar |
| Urlabhra go Téacs | 2 creidmheasanna | in aghaidh an nóiméid fuaime |
| Clónáil Gutha | 4 creidmheasanna | in aghaidh 1, 000 carachtar |
| Athraigh GuthName | 3 creidmheasanna | in aghaidh an nóiméid fuaime |
| Feabhsú Fuaime | 2 creidmheasanna | in aghaidh an nóiméid fuaime |
| Deireadh a chur le Guth / Scaipeadh Stem | 3-4 creidmheas | in aghaidh an nóiméid fuaime |
| Aistriúchán Urlabhra | 5 creidmheasanna | in aghaidh an nóiméid fuaime |
| Comhrá GuthaComment | 3 creidmheasanna | in aghaidh an tsaoil |
| Aimsitheoir Eochair & BPM | Saor | -- |
| Tiontaire FuaimeName | Saor | -- |
Téacs- go- Caint
Tiontaigh téacs go fuaime cainte. Fillfidh sé seo comhad fuaime san fhormáid iarrtha.
Corp an Iarratais
| Paraiméadair | Cineál | Riachtanach | Cur Síos |
|---|---|---|---|
| model | string | & Ná Sábháil | Aitheantas Samhail (m.sh. kokoro, chatterbox, piper) |
| text | string | Tá | Téacs le tiontú go caint (uasmhéid 5,000 carachtar le haghaidh Pro, 50,000 le haghaidh Enterprise) |
| voice | string | Tá | Aitheantas Gutha (úsáid /v1/voices/ chun na guthanna atá ar fáil a liostáil) |
| format | string | & Ná Sábháil | Formáid aschurtha: mp3 (réamhshocraithe), wav, flac, ogg |
| speed | float | & Ná Sábháil | Iolraitheoir luais labhartha. Réamhshocrú: 1.0. Raon: 0.5 go 2.0 |
| language | string | & Ná Sábháil | Cód teanga (m.sh. en, es). Braitear go huathoibríoch é má fhágtar ar lár é. |
| instructions | string | & Ná Sábháil | Cúiseanna gníomhaíochta / seachadta (≤500 carachtar). m.sh. \ |
| pronunciations | object | array | & Ná Sábháil | Sáraithear fuaimniú de réir iarratais. {\ |
| stream | boolean | & Ná Sábháil | Cumasaigh freagra sruthaithe. Réamhshocrú: false |
Iarratas Samplach
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
Clibeanna SSML
Uimhreacha, dátaí, airgeadra, uimhreacha teileafóin, agus acrainmneacha a fhilleadh i Formáid réamhshocraithe an dáta: 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 Ionchur Labhairt mar cardinal1234one thousand two hundred thirty-four ordinal21twenty-first date1999-12-31Nollaig tríocha-aon, naoi déag nócha-naoi 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 le haghaidh Béarla agus dmy in áiteanna eile; sáraigh le 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."
}Freagra
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.Sampla iomlán
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.
Urlabhra go Téacs
Trascríobh fuaime go téacs. Tacaíonn 99 teanga le auto- bhrath.
Corp an Iarratais (multipart/form-data)
| Paraiméadair | Cineál | Riachtanach | Cur Síos |
|---|---|---|---|
| file | file | Tá | Comhad fuaime (MP3, WAV, FLAC, OGG, M4A, MP4, WebM). Uasmhéid 100MB. |
| model | string | & Ná Sábháil | Samhail STT: whisper (réamhshocrú), faster-whisper, sensevoice |
| language | string | & Ná Sábháil | Cód teanga. auto le haghaidh braite uathoibríoch (réamhshocrú). |
| timestamps | boolean | & Ná Sábháil | Cuir stampaí ama ar leibhéal focal san áireamh. Réamhshocrú: false |
| diarize | boolean | & Ná Sábháil | Cumasaigh diailiú cainteoirí. Réamhshocrú: false |
Freagra
{
"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"
}
]
}
Clónáil Gutha
Gineann sé seo guth clónáilte. Uasluchtaigh fuaim agus téacs tagartha.
Corp an Iarratais (multipart/form-data)
| Paraiméadair | Cineál | Riachtanach | Cur Síos |
|---|---|---|---|
| reference_audio | file | Tá | Fuaim guth tagartha (moltar 10-30 soicind). Max 20MB. |
| text | string | Tá | Téacs le labhairt sa ghuth clónáilte. |
| model | string | & Ná Sábháil | Samhail chlónála: chatterbox (réamhshocrú), cosyvoice2, gpt-sovits |
| format | string | & Ná Sábháil | Formáid aschurtha: mp3 (réamhshocraithe), wav, flac |
| language | string | & Ná Sábháil | Cód na sprioctheanga. Caithfidh an tsamhail roghnaithe tacú leis. |
Freagra
Fill an comhad fuaime mar shonraí dénártha, mar an gcéanna leis an gcríochphointe TTS.
Athraigh GuthName
Tiontaigh fuaime a fhuaim cosúil le guth éagsúla. Uasluchtaigh foinse fuaime agus roghnaigh sprioc guth.
Corp an Iarratais (multipart/form-data)
| Paraiméadair | Cineál | Riachtanach | Cur Síos |
|---|---|---|---|
| file | file | Tá | Comhad fuaime foinse (MP3, WAV, FLAC). Uasmhéid 50MB. |
| target_voice | string | Tá | Sprioc- aitheantas gutha le tiontú go (úsáid /v1/voices/ chun na guthanna atá ar fáil a liostáil) |
| model | string | & Ná Sábháil | Samhail chomhshó gutha: openvoice (réamhshocrú), knn-vc |
| format | string | & Ná Sábháil | Formáid aschurtha: wav (réamhshocraithe), mp3, flac |
Iarratas Samplach
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
Freagra
Fill an comhad fuaime comhshóite mar shonraí dénártha.
Aistriúchán Urlabhra
Aistriú fuaime labhartha ó theanga amháin go teanga eile.Comhcheanglaíonn urlabhra-go-téacs, aistriúchán, agus téacs-go-urlabhra i glaoch amháin.
Corp an Iarratais (multipart/form-data)
| Paraiméadair | Cineál | Riachtanach | Cur Síos |
|---|---|---|---|
| file | file | Tá | Comhad fuaime foinseach sa bhunteanga. Uasmhéid 100MB. |
| target_language | string | Tá | Cód na sprioctheanga (m.sh. es, fr, de, ja) |
| voice | string | & Ná Sábháil | Guth le haghaidh aschurtha aistrithe. Roghnófar go huathoibríoch é mura ndéantar é. |
| preserve_voice | boolean | & Ná Sábháil | Déan iarracht an cainteoir bunaidh a chaomhnú |
Freagra
{
"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
}
Urlabhra go Urlabhra
Trasfhoirmigh stíl cainte, mothúchán, nó seachadadh agus an t- ábhar á choinneáil. Úsáideach chun ton, luas, agus sainráiteacht a choigeartú.
Corp an Iarratais (multipart/form-data)
| Paraiméadair | Cineál | Riachtanach | Cur Síos |
|---|---|---|---|
| file | file | Tá | Comhad fuaime cainte foinseach. Uasmhéid 50MB. |
| voice | string | Tá | Sprioc- Aitheantas Gutha don chaint aschurtha |
| model | string | & Ná Sábháil | Samhail: openvoice (réamhshocrú), chatterbox |
| emotion | string | & Ná Sábháil | Sprioc- mhothúchán: neutral, happy, sad, angry, excited |
| speed | float | & Ná Sábháil | Coigeartú luais. Réamhshocrú: 1.0. Raon: 0.5 go 2.0 |
Freagra
Fill an comhad fuaime trasfhoirmithe mar shonraí dénártha.
Uirlisí FuaimeName
Deireadhphointí próiseála fuaime chun feabhas a chur, a bhaint gutha, scoilteadh gas, agus níos mó.
Feabhas a chur ar cháilíocht fuaime: denoise, soiléireacht a fheabhsú, réiteach Super.
| file file | Comhad fuaime le feabhsú |
| denoise boolean | Cumasaigh díthorann (réamhshocrú: true) |
| enhance_clarity boolean | Feabhsaigh soiléireacht na cainte (réamhshocrú: true) |
| super_resolution boolean | Cáilíocht fuaime uasscálaithe (réamhshocrú: bréagach) |
| strength integer | 1- 3 (éadrom, meánach, láidir). Réamhshocrú: 2 |
Guthaí ar leith ó uirlisí (baint gutha) nó scoilt i gais.
| file file | Comhad fuaime le scaradh |
| model string | demucs (réamhshocraithe) nó spleeter |
| stems integer | Líon na ngeall: 2, 4, 5, nó 6 (réamhshocrú: 2) |
| format string | Formáid aschurtha: wav, mp3, flac |
Bain macalla agus reverb ó thaifeadtaí fuaime.
| file file | Comhad fuaime le próiseáil |
| type string | echo or reverb (default: both) |
| intensity integer | 1-5 (default: 3) |
Anailís fuaime a bhrath eochair, BPM, agus síniú ama.
| file file | Comhad fuaime le hanailísiú |
{
"key": "C",
"scale": "Major",
"bpm": 120.0,
"time_signature": "4/4",
"camelot": "8B",
"compatible_keys": ["C Major", "G Major", "F Major", "A Minor"]
}
Tiontaigh fuaime idir formáidí.
| file file | Comhad fuaime le tiontú |
| format string | Spriocfhormáid: mp3, wav, flac, ogg, m4a, aac |
| bitrate integer | Ráta giotán aschurtha i kbps: 64, 128, 192, 256, 320 |
| sample_rate integer | Ráta samplach: 22050, 44100, 48000 |
| channels string | mono nó stereo |
Comhrá GuthaComment
Seol fuaime nó téacs agus freagra AI a fháil le caint shintéisiú.
Corp an Iarratais (multipart/form-data nó JSON)
| Paraiméadair | Cineál | Riachtanach | Cur Síos |
|---|---|---|---|
| audio | file | & Ná Sábháil* | Ionchur fuaime (audio nó text ag teastáil) |
| text | string | & Ná Sábháil* | Ionchur téacs (audio nó text ag teastáil) |
| voice | string | & Ná Sábháil | Guth le haghaidh freagra AI. Réamhshocrú: af_bella |
| tts_model | string | & Ná Sábháil | Samhail TTS don fhreagra. Réamhshocrú: kokoro |
| system_prompt | string | & Ná Sábháil | Pras córais saincheaptha le haghaidh AI |
| conversation_id | string | & Ná Sábháil | Lean comhrá atá ann cheana |
Freagra
{
"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
}
Baisc TTS
Cuir téacsanna iolracha isteach le haghaidh giniúna comhthreomhara TTS. Roghnach, faigh aisghlao webhook nuair a chríochnaíonn gach jab.
Paraiméadair
| Paraiméadair | Cineál | Cur Síos |
|---|---|---|
| texts | array | Array of objects: {text, model, voice}. Max 50 items. |
| webhook_url | string | URL Roghnach chun torthaí POST nuair a chríochnaíonn bhaisc. |
Freagra
{
"batch_id": "abc123",
"total": 3,
"completed": 0,
"status": "processing"
}
Dul chun cinn na vótála le GET /v1/tts/batch/result/?batch_id=abc123
Leabaigh Guth
Réamhríomh leabaithe gutha ó fhuaim tagartha. Úsáid an embed_id a fhillfear in iarratais chlónála gutha ina dhiaidh sin le haghaidh giniúna beagnach láithreach.
Paraiméadair
| Paraiméadair | Cineál | Cur Síos |
|---|---|---|
| file | file | Reference audio file (WAV, MP3, FLAC). |
| model | string | Cloning model (default: chatterbox). Supported: chatterbox, cosyvoice2, openvoice, gpt-sovits, spark, indextts2, qwen3-tts. |
Freagra
{
"embed_id": "emb_abc123",
"model": "chatterbox",
"duration_ms": 450
}
Seiceáil Sláinte
Seiceáil stádas an fhreastalaí GPU, samhlacha luchtaithe, agus méid an chiú. Níl aon fhíordheimhniú de dhíth. Tá an taisce ar feadh 30 soicind.
Freagra
{
"status": "online",
"latency_ms": 45,
"queue_size": 3,
"models_loaded": ["kokoro", "chatterbox", "cosyvoice2"]
}
Liosta Samhlacha
Fillteáin liosta de na samhlacha go léir atá ar fáil lena gcumas.
Freagra
{
"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
}
]
}
Liosta Guthanna
Fillteann sé seo liosta de na guthanna go léir atá ar fáil, scagtha de réir múnla nó teanga.
Paraiméadair an Iarratais
| Paraiméadair | Cineál | Cur Síos |
|---|---|---|
| model | string | Scag de réir aitheantais mhúnla (m.sh. kokoro) |
| language | string | Scag de réir cód teanga (m. sh. ga) |
| gender | string | Scag de réir inscne: female, female, neutral |
Freagra
{
"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
}
Fotheidil (SRT / VTT) nua
Gineann sé seo fotheidil shioncronaithe d' aon jab TTS críochnaithe. Riteann sé ailíniú Whisper thar an fhuaim agus fillteann sé SRT nó WebVTT. Déantar an toradh a thaisceadh ar an diosca, mar sin is léitheoireacht diosca é an dara glaoch ar an uuid céanna.
Paraiméadair an Iarratais
| Paraiméadair | Riachtanach | Cur Síos |
|---|---|---|
| uuid | Tá | UUID an jabanna a d'fhill /v1/tts/ nó /v1/voice-clone/. |
| format | & Ná Sábháil | srt (réamhshocrú) nó vtt. |
| download | & Ná Sábháil | 1 chun Content-Disposition: attachment a sheoladh ionas go sábhálfaidh an brabhsálaí seachas go dtaispeánfaidh sé. |
| language | & Ná Sábháil | Leid don tsamhail ailínithe (a bhraitear go huathoibríoch má fhágtar ar lár é). |
curl "https://api.tts.ai/v1/speech/subtitles/?uuid=$UUID&format=srt&download=1" -o subtitles.srt
Foclóir Fuaimnithe nua
Cuir in iúl don inneall TTS conas focail áirithe a fhuaimniú. Cuirfear iontrálacha sábháilte i bhfeidhm go huathoibríoch ar gach iarratas TTS a dhéanann tú. Teorainn 200 iontráil in aghaidh an chuntais.
Corp an Iarratais (POST)
| Paraiméadair | Cineál | Cur Síos |
|---|---|---|
| word | string | Focal le sárú (m.sh. GIF, Anthropic). Comhoiriúnú teorann focal. |
| replacement | string | Conas é a litriú don tsamhail (m.sh. jiff, ann THROP ick). |
| language | string | Cód ISO roghnach. Folamh = baineann sé le gach teanga. |
| case_sensitive | boolean | Réamhshocrú false. Comhoiriúnaigh cás go díreach nuair a bhíonn 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-..."
Is féidir leat sáruithe in aghaidh an iarratais a chur ar aghaidh freisin gan iad a shábháil — cuir pronunciations ar aon ghlao /v1/tts/ mar rud nó mar eagar (féach na paraiméadair deiridh TTS).
Cainteoir Alt nua
Buail tag amháin ar aon leathanach alt agus gheobhaidh cuairteoirí barra léitheoir seasta a insíonn an leathanach ar chliceáil. Auto- bhraitheann an comhlacht alt, tacaíonn guth saincheaptha / samhail / seasamh / dath 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>
Roghanna
| Paraiméadair | Cur Síos |
|---|---|
data-pk | Eochair infhoilsithe (pk-tts-…). Forchuirtear srianta fearainn trí réimse allowed_domains na heochrach. |
data-voice | Aitheantas gutha. Réamhshocrú af_bella. |
data-model | Aitheantas na samhla TTS. Réamhshocrú kokoro. |
data-extract | auto (réamhshocrú) — déanann sé iarracht ar roghnóirí article/main/.post-content/.entry-content, agus téann sé ar ais go dtí an braisle míre is dlúithe. Nó pas aon roghnóir CSS chun díriú ar eilimint ar leith. |
data-position | bottom (réamhshocrú) nó top. |
data-color | Dath aibhsithe (aon dath CSS). Réamhshocrú #e60000. |
data-min-chars / data-max-chars | Ná húsáid an barra má tá an t- alt níos giorra ná an líon carachtar íosta (réamhshocrú: 200). Cuir teorainn leis an líon carachtar uasta (réamhshocrú: 50, 000). |
Giuirléid Chnaipe ÉistName
Leabaigh inlíne i stíl cnaipe. Rindreáiltear in aice leis an gclib < code>< script code> é agus seinnfidh sé blúire ghearr a spreagtar le cnaipe. Cruth difriúil leis an Inneall Airteagail thuas (a instealladh barra leathanaigh go huathoibríoch agus a insíonn an t- alt ar fad).
<script src="https://tts.ai/widget.js"
data-voice="af_bella"
data-model="kokoro"
data-style="full"
data-theme="light"></script>
Guthanna Sábháilte (Clónna Marthanacha)
Uaslódáil tagairt fuaime uair amháin, a fháil ar ais voice_id leanúnach, ansin tagairt a id in iarratais TTS in ionad ath- uaslódáil fuaime gach glaoch. Ideal do chomhtháthú ard- toirt.
Uasluchtaigh guth
POST
https://tts.ai/api/v1/user-voices/
Údarú de dhíth
Réimsí: comhad (riachtanach, 5-30s fuaime), ainm (riachtanach), teanga (roghnach, réamhshocrú en), samhail (roghnach — roghnaíonn cosyvoice2 go huathoibríoch do zh/ja/ko nó openvoice), consent_confirmed (riachtanach, aon luach fíor).
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"
}
Úsáid an guth sábháilte i TTS
POST go /api/v1/tts/ (NÓTA: VPS gréasáin óstach, ní api.tts.ai) le user_voice_id. luchtaimid do fuaime stóráilte agus bealach chun an píblíne clónála.
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.
Liosta / scrios
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
Cartlann / athghníomhachtú (saor in aisce)
Fanann guthanna cartlainne i do chuntas ach ní féidir iad a úsáid i TTS. Úsáideach d' úsáideoirí deiridh díomhaoin ionas go bhfanfaidh do liosta glan.
POST https://tts.ai/api/v1/user-voices/uv_a1b2c3d4e5f6/archive/
POST https://tts.ai/api/v1/user-voices/uv_a1b2c3d4e5f6/reactivate/
Samplaí Cóid
Téacs- go- Caint
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')}")
Urlabhra go Téacs
# 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"])
Clónáil Gutha
# 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)
Téacs- go- Caint
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();
Urlabhra go Téacs
// 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);
Téacs- go- Caint
# 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
Urlabhra go Téacs
# 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"
Clónáil Gutha
# 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
Feabhsú Fuaime
# 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
Cóid Earráide
Gach earráidí ar ais freagra JSON le error réimse.
{
"error": {
"code": "insufficient_credits",
"message": "You do not have enough characters for this request.",
"characters_required": 4000,
"characters_available": 2000
}
}
| Stádas HTTP | Cód Earráide | Cur Síos |
|---|---|---|
| 400 | bad_request |
Paraiméadair neamhbhailí iarratais. Féach ar an teachtaireacht earráide le haghaidh sonraí. |
| 401 | unauthorized |
Eochair API ar iarraidh nó neamhbhailí. |
| 402 | insufficient_credits |
Níl go leor creidmheasanna agat. Ceannaigh níos mó ag /pricing/. |
| 403 | forbidden |
Níl cead agat an acmhainn seo a rochtain (m.sh. pobalbhreith a dhéanamh ar phost úsáideora eile). Tá rochtain API féin san áireamh i ngach plean. |
| 404 | not_found |
Samhail nó guth gan aimsiú. |
| 413 | file_too_large |
Sáraíonn an comhad uasluchtaithe an teorainn mhéide. |
| 429 | rate_limited |
An iomarca iarratas. Seiceáil ceanntásca na dteorainneacha ráta. |
| 500 | internal_error |
Earráid fhreastalaí. Bain triail eile as níos déanaí. |
| 503 | model_loading |
Samhail á luchtú. Bain triail eile as i gceann cúpla soicind. |
Hookanna Gréasáin
I gcás tascanna fada (scoilteadh gas, TTS baisc), is féidir leat paraiméadar webhook_ url a sholáthar. Nuair a bheidh an tasc críochnaithe, cuirfimid an toradh chuig do URL.
{
"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"
}
Réidh le Tógáil?
Faigh d'eochair API agus tosú ag comhtháthú TTS.ai i do chuid iarratas.