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
}
Guthanna Sábháilte
List the cloned voices saved to your account, including the public_id you pass as the voice for later generations, and the stored reference audio URL. Also accepts POST (multipart) to create a voice and DELETE ?public_id=uv_xxx to remove one.
Freagra
{
"voices": [
{
"public_id": "uv_30d109336d05",
"name": "My Voice",
"model_name": "openvoice",
"voice_id": "",
"preview_url": "https://tts.ai/media/user-voices/....wav",
"reference_audio_url": "https://tts.ai/media/user-voices/....wav",
"storage_status": "active"
}
],
"quota": { "setup_chars": 500, "per_use_chars": 50 }
}
Tá guthanna sábháilte inroghnaithe freisin san uirlis Chlónála Gutha, na piocóirí óstach Gineadóir Podchraolta AI, agus na piocóirí Il-Guth in aghaidh an chainteora.
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ú #e60. |
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/voice-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/voice-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.