APIపత్రరచన
మా RSTAPI తో TTS.ai అప్టిక్ చేయండి. సులభంగా వలసల కోసం ఓపెన్ అప్లేట్ ఫార్మాట్.
సవరింపు
TTS.ai API ప్రోగ్రామ్ అన్ని ప్లాట్ఫాం సౌలభ్యాలను యాంత్రికంగా వాడుతుంది: టెక్స్ట్-భాష- స్లైటిస్, పదకోశం-పాఠపు ఉద్భవం, క్యోలింగ్, ఆడియో అభివృద్ది, ఇంకా. API జాన్ అభ్యర్ధన/ resposse secs శరీరాలు తో ప్రామాణిక RETలను ఉపయోగిస్తుంది.
API కీ
మీ API కీని బయటకు పొందండి ఖాతా అమరికలు. ప్రొ అండ్ ఇండెక్స్ పథకాల్లో అందుబాటులో ఉంది.
మూల యూఆర్ఎల్
https://api.tts.ai/v1/
నిసాన్
ట్రాన్సియంట్ ద్వారా కర్రర్ (careder) సంకేతం Authorization ఎగువ సూచి
ధృవీకరణ
/v1/tts/ ఏ uth లేకుండా పని, ఒక IP/ రోజు వరకు 5,000 అక్షరాలు, మా స్వేచ్ఛా మోడల్ ఏ (piper, vits, melotts, kokoro). 15,000 బోనస్ అక్షరాలు, అరుదైన మొబైల్లను కనెక్ట్ చేయడానికి ఉచిత ఖాతా కోసం సంతకం చేయండి.
సాటిలేని మోడల్లు మరియు అధిక రేటులకు, బర్నిర్ ఇన్ఫెక్షన్తో ధృవీకరణము చేయుము Authorization ఎగువ సూచి.
Authorization: Bearer sk-tts-your-api-key-here
ఎస్ డికెస్Name
అధికారిక SDKs TTS.ai ను మీ దరఖాస్తు లోకి నడుపుటకు సులభంగా చేస్తుంది. ఈ రెండూ Gtmobపై ఓపెన్ సోర్సును మరియు అందుబాటులో ఉంటాయి.
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కు సంబంధించిన అన్ని ముగింపు పాయింట్లు. ఉదాహరణకు TTS ముగింపు పాయింట్:
రేటు పరిమితులు
API రేటు ప్రణాళిక ద్వారా భేదిస్తుంది:
| పథకం | అభ్యర్ధనలు/నిం | ప్రస్తుతము | గరిష్ఠ వాచకం పొడవు |
|---|---|---|---|
| ఖాళీ | 10 | 2 | 500 అక్షరములు |
| ప్రారంభించు | 30 | 3 | 10,00,000 అక్షరములు |
| పధ్ధతి | 60 | 5 | 10,00,000 అక్షరములు |
| ఎన్లైట్బాక్స్Name | 300 | 20 | 50,000 అక్షరములు |
ప్రతి ప్రతిస్పందననందు రేట్ శీర్షికలు జతచేయబడినవి: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
రుణాలు
| సేవ | విలువ | యూనిట్ |
|---|---|---|
| TTS (ఫ్రెడ్ మోడల్: Pyper, VITS, మెలోట్సిస్) | 1,000 అక్షరములు | 1,000 అక్షరాలకు |
| TTS (సమావేశపు మోడల్లు: కోకోరో, కొసీవోసిస్ 2 [.]) | 2,000 అక్షరములు | 1,000 అక్షరాలకు |
| TTS (ప్రిమమ్ మోడల్లు: టోర్టోజెస్, చాటర్బాక్స్, మొదలైన) | 4,000 అక్షరములు | 1,000 అక్షరాలకు |
| (w) వచనముకు మాట్లాడు | 2,000 అక్షరములు | ఆడియోకు ఒక నిమిషం |
| శబ్డం క్లుంకింగ్ | 4,000 అక్షరములు | 1,000 అక్షరాలకు |
| ధ్వని మార్చునది | 3,000 అక్షరములు | ఆడియోకు ఒక నిమిషం |
| ఆడియో అభివృద్ది | 2,000 అక్షరములు | ఆడియోకు ఒక నిమిషం |
| క్లోమం / స్టేజ్చేయడం | 3,000- 3,000 అక్షరములు | ఆడియోకు ఒక నిమిషం |
| (e) సంభాషణ అనువాదముName | 5,000 అక్షరములు | ఆడియోకు ఒక నిమిషం |
| ధ్వని చాట్ | 3,000 అక్షరములు | ప్రతి స్పీచ్ |
| కీ (BPM శోధన) కనుగొనునది | ఖాళీ | -- |
| ఆడియో మార్పుకారి | ఖాళీ | -- |
మాట్లాడటానికి వచనం
పాఠ్యమును భాషా ఆడియోకు మార్చుము. అభ్యర్దించిన ఫార్మాట్లో ఆడియో ఫైల్ను తిరిగివుంచుతుంది.
అభ్యర్దించిన శరీరము
| పెరామీటరు | రకము | అవసరం | విశదీకరణము |
|---|---|---|---|
| model | string | వద్దు | మోడల్ ID (e.e., > |
| text | string | అవును | మాట్లాడుటకు వచనమును మార్చుటకు. per-requeror up: 500 అక్షరాలు (మానవ ఎగుమతి), 5,000 (స్పష్టమైన ఖాతా), 10,00,000 (పాదిరీ ప్రణాళిక). పొడవైన ఇన్పుట్లు సర్వర్- బ్యూటీ- భాగంగా ఉంటాయి. |
| voice | string | అవును | నంబర్ ఐడి (అంటే ) |
| format | string | వద్దు | అవుట్పుట్ ఫార్మేట్: |
| speed | float | వద్దు | వేగం అధికం చేయుచున్నది. అప్రమేయం: >> < |
| language | string | వద్దు | భాష కోడ్ (ఉ. దా., , < కోడ్>). వదిలివేయబడినట్లైతే స్వయంచాలక-వేడించబడుతుంది. |
| instructions | string | వద్దు | యాక్సింగ్ / డెంగరీ క్యూలు ($500 అక్షరములు). e.e.c \ |
| pronunciations | object | array | వద్దు | పర్- రిప్రెషన్ ఉచ్ఛారణలు. ఏమైన < కోడ్> <\] |
| stream | boolean | వద్దు | స్ట్రీమ్ స్పందనను చేతనముచేయుము. అప్రమేయం: |
ఉదాహరణలు అభ్యర్ధన
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
SSSML టాగ్స్
దింపు సంఖ్యలు, తేదీలు, డబ్బులు, ఫోన్ సంఖ్యలు, మరియు అక్రోనోనిమ్స్ తేదీ ఫార్మాట్ 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
ఇయాగ్నెస్ మూలాంశము చిరుతపులి 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 >=\{
"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."
}స్పందన
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.
(w) వచనముకు మాట్లాడు
ఆడియోను పాఠ్యానికి పంపుము. స్వయంచాలక- డిక్లరేషన్ తో 99 భాషలకు మద్దతిస్తుంది.
అభ్యర్దించిన శరీరము (multipart/form-data)
| పెరామీటరు | రకము | అవసరం | విశదీకరణము |
|---|---|---|---|
| file | file | అవును | ఆడియో ఫైల్ (MP3, WAV, OGG, MGA, MP4, వెబ్సైట్. Mac 100MB) |
| model | string | వద్దు | STD మోడల్: |
| language | string | వద్దు | భాష కోడ్. <కోడ్> യാന്ത്രിക-దిశాంశం (అప్రమేయంగా) కోసం |
| timestamps | boolean | వద్దు | పదము- స్థాయి సమయాలను జోడించు. అప్రమేయం: |
| diarize | boolean | వద్దు | స్పీకర్ డిజైన్ను చేతనముచేయుము. అప్రమేయం: |
స్పందన
{
"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"
}
]
}
శబ్డం క్లుంకింగ్
రిఫరెన్స్ వాయిడ్ ధ్వనిలో భాషను తయారుచేయి. రిఫరెన్స్ ఆడియో మరియు వచనమును తిరిగిలోడు చేయుము.
అభ్యర్దించిన శరీరము (multipart/form-data)
| పెరామీటరు | రకము | అవసరం | విశదీకరణము |
|---|---|---|---|
| reference_audio | file | అవును | రిఫరెన్స్ ఆడియో 10-30 సెకనుల సిఫార్సు చేసింది. మాక్స్ 20MB. |
| text | string | అవును | క్లోన్ వాయిస్ లో మాట్లాడటానికి వచనము. |
| model | string | వద్దు | క్లోన్ మోడల్: |
| format | string | వద్దు | అవుట్పుట్ ఫార్మేట్: |
| language | string | వద్దు | లక్ష్యపు భాష కోడ్. ఎంచుకొన్న మోడల్ తో మద్దతీయబడాలి. |
స్పందన
ఆడియో ఫైల్ను TTS ముగింపు పాయింట్ వంటి, ద్విముఖ డాటా వలె తిరిగివుంచుతుంది.
ధ్వని మార్చునది
ఆడియోను వేరొక శబ్దమువలె మారుము. మూల ఆడియోను లోడుచేసి లక్ష్యపు శబ్దమును యెంపికచేయుము.
అభ్యర్దించిన శరీరము (multipart/form-data)
| పెరామీటరు | రకము | అవసరం | విశదీకరణము |
|---|---|---|---|
| file | file | అవును | సోర్స్ ఆడియో ఫైల్ (MP3, WAV, FLAC) మాస్ 50MB. |
| target_voice | string | అవును | టాగ్సు ID (అవుట్ వాయిస్లను జాబితాకు బదిలీ చేయించుటకు |
| model | string | వద్దు | మెళకువ మోడల్: |
| format | string | వద్దు | అవుట్పుట్ ఫార్మాట్: |
ఉదాహరణలు అభ్యర్ధన
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
స్పందన
మార్చబడిన ఆడియో ఫైల్ను ద్విముఖ డాటాగా తిరిగివుంచుతుంది.
(e) సంభాషణ అనువాదముName
ఒక భాష నుండి మరో దానికి ఆడియోను అనువదించండి. ఒకే కాల్లో పదాలు, పదాలు, అనువాదము, మరియు పాఠ్యము- నుండి పదాలు అనువదించడానికి కాంబెన్లు.
అభ్యర్దించిన శరీరము (multipart/form-data)
| పెరామీటరు | రకము | అవసరం | విశదీకరణము |
|---|---|---|---|
| file | file | అవును | అసలు భాషలోని మూల ఆడియో ఫైల్. మాస్ 100MB. |
| target_language | string | అవును | లక్ష్యపు భాష కోడ్ (e.g., |
| voice | string | వద్దు | అనువదించిన అవుట్పుట్కు ఆబ్జక్టు. విడిచినట్లైతే స్వయంచాలక- ఎంపికచేయు. |
| preserve_voice | boolean | వద్దు | అసలైన స్పీకర్ యొక్క స్వర లక్షణాలను భద్రపరచడానికి ప్రయత్నిస్తుంది. అప్రమేయం: |
స్పందన
{
"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
}
మాట్లాడేటప్పుడు
ఆంతరంగిక సంభాషణా శైలిని, భావావేశాన్ని, పోషణను మార్చండి.
అభ్యర్దించిన శరీరము (multipart/form-data)
| పెరామీటరు | రకము | అవసరం | విశదీకరణము |
|---|---|---|---|
| file | file | అవును | సోర్స్ ఆడియో ఫైల్. మాస్ 50MB |
| voice | string | అవును | అవుట్పుట్ పదమునకు టార్గెట్ వర్డ్ స్వరము ఐడి |
| model | string | వద్దు | మోడల్: |
| emotion | string | వద్దు | లక్ష్యము: |
| speed | float | వద్దు | వేగము సవరించబడింది. అప్రమేయ: > < |
స్పందన
మార్చబడిన ఆడియో ఫైల్ను ద్విముఖ డాటాగా తిరిగివుంచుతుంది.
ఆడియో పనిముట్లు
ఆ తర్వాత, వాటి ట్యూబ్లు తెరుచుకుని, ఆ తర్వాత ఆ తర్వాత వాటిపై దాడి చేయడం ప్రారంభిస్తాయి.
ఆడియో నాణ్యతను మెరుగుపరుచుము: డినోజెజ్, స్పష్టత, సూపర్వైజ్ రెజొల్యూషన్ను మెరుగుపరుచుము.
| file file | పెద్దదిచేయుటకు ఆడియో ఫైల్ |
| denoise boolean | రౌలానింగ్ను చేతనముచేయుము (అప్రమేయ: సత్యం) |
| enhance_clarity boolean | పెద్దదిచేసిన పద స్పష్టము (default: rue) |
| super_resolution boolean | పైకి పెద్దదిచేసిన ఆడియో నాణ్యత ( అప్రమేయ: తప్పు) |
| strength integer | 1- 3 (వెలుగు, మధ్యలో, బలమైన). అప్రమేయ: 2 |
ఆ యంత్రాలు (ప్రత్యేకత తీసివేయబడిన) నుండి విడివిడిగా పాడండి లేదా roots (విరమించడం) roots (విరమించడం) లోకి విడగొట్టండి.
| file file | విడగొట్టుటకు ఆడియో ఫైల్ |
| model string | demucs (అప్రమెయం) లేదా spleeter |
| stems integer | మూలాల సంఖ్య: 2, 4, 5, 6 ( అప్రమేయం: 2) |
| format string | అవుట్పుట్ ఫార్మాట్: |
ఆడియో రికార్డింగుల నుండి ఓవర్రైడ్ మరియు reverbను తీసివేయండి.
| file file | ప్రాసెస్ చేయుటకు ఆడియో దస్త్రము |
| type string | echo or reverb (default: both) |
| intensity integer | 1-5 (default: 3) |
కీ, BPM, మరియు సమయ సంతకంను శోధించుటకు ఆడియోను విశ్లేషించుము.
| file file | విశ్లేషించుటకు ఆడియో దస్త్రము |
{
"key": "C",
"scale": "Major",
"bpm": 120.0,
"time_signature": "4/4",
"camelot": "8B",
"compatible_keys": ["C Major", "G Major", "F Major", "A Minor"]
}
ఫార్మాట్ల మధ్య ఆడియోను మార్చుము
| file file | మార్చుటకు ఆడియో ఫైల్ను |
| format string | లక్ష్యం: , |
| bitrate integer | అవుట్పుట్ బిట్రేట్: 64, 128, 192, 256,320 లో |
| sample_rate integer | మాదిరి రేటు: 22050, 44100, 48000 |
| channels string | mono లేదా stereo |
ధ్వని చాట్
ఆడియో లేదా పాఠ్యమును పంపించి అభ్యర్ధమైన సంభాషణతో AI ప్రతిస్పందనను పొందుము.
అభ్యర్దించిన శరీరము (multipart/form-data లేదా JSON)
| పెరామీటరు | రకము | అవసరం | విశదీకరణము |
|---|---|---|---|
| audio | file | వద్దు* | ఆడియో ఇన్పుట్ (పరుడుకు |
| text | string | వద్దు* | వాచకం ఇన్పుట్ (టీఫ్ |
| voice | string | వద్దు | AI స్పందన కొరకు శబ్దము. అప్రమేయ: |
| tts_model | string | వద్దు | సమాధానం కొరకు TTS మోడల్. అప్రమేయ: |
| system_prompt | string | వద్దు | నిర్దేశిత వ్యవస్థ AI కు ప్రాధాన్యాన్నిస్తుంది |
| conversation_id | string | వద్దు | ప్రస్తుతం వున్న సంభాషణ కొనసాగించుము |
స్పందన
{
"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
}
బృందం
TTS తరం కొరకు బహుళ మూలపాఠాలను అందించుము. అన్ని ఉద్యోగాలు పూర్తి అయినప్పుడు, ఇష్టమైన విధంగా వెబ్ హుక్ కాల్ను స్వీకరించుము.
పారామితి
| పెరామీటరు | రకము | విశదీకరణము |
|---|---|---|
| texts | array | Array of objects: {text, model, voice}. Max 50 items. |
| webhook_url | string | Optional URL to POST results when batch completes. |
స్పందన
{
"batch_id": "abc123",
"total": 3,
"completed": 0,
"status": "processing"
}
Get/v1/tts/botch/ barsult/? బాట్క్=dibc123 తో పోల్ పురోగతి?
శబ్దపు పొదగింగ్Name
రిఫరెన్స్ ఆడియో నుండి ఒక స్వరం ముందు eembonedను ఆమోదించుము. తరువాత డీమింగ్ అభ్యర్ధనలను సమీపస్థాపించుటకు ఆబ్జక్టు నందు తిరిగి embed వుపయోగించుము.
పారామితి
| పెరామీటరు | రకము | విశదీకరణము |
|---|---|---|
| file | file | Reference audio file (WAV, MP3, FLAC). |
| model | string | Cloning model (default: chatterbox). Supported: chatterbox, cosyvoice2, openvoice, gpt-sovits, spark, indextts2, qwen3-tts. |
స్పందన
{
"embed_id": "emb_abc123",
"model": "chatterbox",
"duration_ms": 450
}
ఆరోగ్యం తనిఖీ
GPU సర్వర్ స్థితిని పరిశీలించుము, మోడల్ మరియు వరుస పరిమాణమును లోడ్ చెయబడింది. ఏ ధృవీకరణ అవసరములేదు. క్యాచీ 30 సెకనుల పాటు.
స్పందన
{
"status": "online",
"latency_ms": 45,
"queue_size": 3,
"models_loaded": ["kokoro", "chatterbox", "cosyvoice2"]
}
జాబితా మోడల్లు
అందుబాటులో వున్న మోడల్సు జాబితాను వాటి సామర్ధ్యములతో తిరిగివుంచుము
స్పందన
{
"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
}
]
}
జాబితా శబ్ధముల జాబితా
అందుబాటులో వున్న అన్ని స్వరాల జాబితాను తిరిగివుంచుము, ఐచ్చికంగా మోడల్ ద్వారా లేదా భాష ద్వారా నవీకరించబడినవి.
ప్రశ్న పారామితులు
| పెరామీటరు | రకము | విశదీకరణము |
|---|---|---|
| model | string | నమూనా ఐడి ద్వారా ఫిల్టర్ (ఉ. దా., |
| language | string | భాష కోడ్నుండి ఫిల్టర్ను వడపోయుము (ఉ. దా., |
| gender | string | లిపి ద్వారా ఫిల్టర్: |
స్పందన
{
"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
}
ఉపశీర్షికలు (SRT / VTT) కొత్త పూర్తిరోజు నియామకాన్ని సృష్టించుNew
పూర్తి TTS పని కొరకు సిద్దీకరించబడిన ఉపశీర్షికలను తయారుచేయుము. ఆడియో కొరకు Whiteper సర్టిఫికెట్ను నడుపుతుంది మరియు SRT లేదా వెబ్ విటిట్యూట్ను తిరిగి వస్తుంది. వుపలభ్యత డిస్కునందు క్యాచీవేయబడుతుంది కాబట్టి అదే uuid కోసం రెండవ కాల్.
ప్రశ్న పారామితులు
| పెరామీటరు | అవసరం | విశదీకరణము |
|---|---|---|
| uuid | అవును | JOB UNION /v1/tts/ లేదా /v1/rue-client ద్వారా తిరిగి వచ్చింది. |
| format | వద్దు | |
| download | వద్దు | |
| language | వద్దు | అమరిక మోడల్కు సూచన (విస్మరించినట్లైతే స్వయంచాలక-వేత చేర్చబడింది). |
curl "https://api.tts.ai/v1/speech/subtitles/?uuid=$UUID&format=srt&download=1" -o subtitles.srt
ఉచ్ఛారణ పదకోశంQuery కొత్త పూర్తిరోజు నియామకాన్ని సృష్టించుNew
TTS ఇంజిన్ కు కొన్ని ప్రత్యేక పదాలను అభ్యర్ధించండి. అన్ని TTS కు మాత్రమే దాచబడిన ప్రవేశాలు మీరు చేసే ప్రతి TTS కు స్వయంచాలకంగా మలుచుకున్న. ఘాటైన ఒక అకౌంట్ పరిమితి 200- ప్రొఫైల్.
అభ్యర్దించిన శరీరము (POST)
| పెరామీటరు | రకము | విశదీకరణము |
|---|---|---|
| word | string | ఓవర్రైడ్ చేయుటకు పదము (ఉ. దా. , < కోడ్ Anitication>, |
| replacement | string | మాదిరికు దానిని వ్యాకరణం చేయవలసింది (ఉ. దా. |
| language | string | ఐచ్చికం ISO కోడ్. ఖాళీ = అన్ని భాషలకు వర్తించబడును. |
| case_sensitive | boolean | అప్రమేయంగా |
# 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-..."
దాయకుండా మీరు ఓవర్రైడ్లను కూడా చేయవచ్చు — ఏదైనా /v1/tts నందలి కోడ్స్కోడింగ్లు
లిపి నార్పరి కొత్త పూర్తిరోజు నియామకాన్ని సృష్టించుNew
ఏ శీర్షిక పుటపైనా
<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>
ఐచ్ఛికాలు
| పెరామీటరు | విశదీకరణము |
|---|---|
data-pk | ప్రచురణలు ప్రచురించగల కీ (pk-ts-...). డొమైన్ ఆంక్షలు కీ యొక్క '%s' నియంత్రితతలను నిర్వర్తిస్తాయి |
data-voice | ID. అప్రమేయమైన |
data-model | TTS మోడల్ ఐడి. అప్రమేయంగా |
data-extract | |
data-position | |
data-color | అకౌంట్ రంగు (ఒక CSS రంగు). అప్రమేయంగా |
data-min-chars / data-max-chars | శీర్షిక కనిష్టంగా ఉంటే బార్ను వదిలివేయుము (అప్రమేయంగా 200). మాక్స్పార్స్లో ఇన్పుట్ (అప్రమేయం) ను కరెంట్ చేయండి. |
QtHeb: < ahref=\
బటన్ విడ్జట్ను వినండి
Lynload-sy-thise-backed. తరువాత(track>)
<script src="https://tts.ai/widget.js"
data-voice="af_bella"
data-model="kokoro"
data-style="full"
data-theme="light"></script>
దాచబడిన పదాలు (ప్రెస్టెంట్ క్లాన్లు)
రిఫరెన్స్ ఆడియోను ఒకసారి అప్లోడ్చేయి, స్థిరమైన స్వరం తిరిగి పొందండి, తరువాత సూచన TTS అభ్యర్ధనలు ప్రతి కాల్ను తిరిగి లోడుచేసే బదులు. అధిక- అన్లాక్రైడ్స్ కొరకు Ice is applications.
స్వరాన్ని ఎక్కించు
POST
https://tts.ai/api/v1/user-voices/
ఏజ్ అవసరం
బహుళ రూపం. ఫీల్స్లు: ఫైలు (gcated, 5- 30s ఆడియో), భాష (ఇతరమైనవి), మోడల్ (ఇతరమైనవి), మోడల్ (ఇతరమైనవి), మోడల్), zH/J/Joo2 (ప్రత్యేక విలువ), సమ్మతి (ప్రత్యేకంగా గుర్తించబడిన).
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"
}
TTS నందు దాచబడిన స్వరాన్ని వుపయోగించుము
/app/v1/tts/ (NOTE: వెబ్ VPS హోస్టు, వినియోగదారు_ prtts.tia తో కాదు. మేము మీరు నిల్వ చేసిన ఆడియో మరియు మార్గం.
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.
జాబితా / తీసివేయు
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
ఆర్చీవ్ / Recacter (స్వయం)
ఆర్కెస్ట్రాల్ వాయిస్ మీ ఖాతాలోఉంటుంది కానీ TTS నందు వుపయోగించకూడదు. చివరి యూజర్లకు ఉపయోగకరంగా ఉండేందుకు అందువలన మీ జాబితా పరిశుభ్రంగా ఉంటుంది.
POST https://tts.ai/api/v1/user-voices/uv_a1b2c3d4e5f6/archive/
POST https://tts.ai/api/v1/user-voices/uv_a1b2c3d4e5f6/reactivate/
కోడ్ ఉదాహరణలు
మాట్లాడటానికి వచనం
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')}")
(w) వచనముకు మాట్లాడు
# 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"])
శబ్డం క్లుంకింగ్
# 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)
మాట్లాడటానికి వచనం
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();
(w) వచనముకు మాట్లాడు
// 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 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
(w) వచనముకు మాట్లాడు
# 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"
శబ్డం క్లుంకింగ్
# 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
ఆడియో అభివృద్ది
# 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
దోషము కూర్పులు
అన్ని దోషములు Jone సమాధానంతో తిరిగివుంచబడతాయి error ఫీల్.
{
"error": {
"code": "insufficient_credits",
"message": "You do not have enough characters for this request.",
"characters_required": 4000,
"characters_available": 2000
}
}
| హెచ్ టిటిపి స్థితి | దోషము కూర్పు | విశదీకరణము |
|---|---|---|
| 400 | bad_request |
చెల్లని అభ్యర్ధన పారామితి. వివరముల కొరకు దోషము సందేశమును పరిశీలించుము. |
| 401 | unauthorized |
API కీ తప్పిపోయింది లేదా చెల్లనిది. |
| 402 | insufficient_credits |
సరిపడే అక్షరాలు కావు. / pricking/. |
| 403 | forbidden |
ఈ వనరును చదువుటకు మీకు అనుమతి లేదు (ఉ. దా. వేరొక యూజర్ యొక్క పనిని వ్రాయుట). API యాక్సెస్ స్వయంగా ప్రతి పథకముపై వున్నది. |
| 404 | not_found |
మోడల్ లేదా స్వరం దొరకలేదు. |
| 413 | file_too_large |
ఎక్కించిన ఫైల్ పరిమాణము గరిష్టం అయింది. |
| 429 | rate_limited |
చాలా ఎక్కువ అభ్యర్ధనలు. రేటు పరిమితి శీర్షికలను పరిశీలించుము. |
| 500 | internal_error |
సెర్వర్ దోషం. తరువాత మళ్ళీ ప్రయత్నించండి. |
| 503 | model_loading |
మోడల్ లోడవుతోంది. కొన్ని సెకన్లలో తిరిగి ప్రయత్నించు. |
వెబ్ టాగ్స్Comment
ఎక్కువ నిగూఢమైన కర్తవ్యాలు (స్కోడ్ విభజన, Carbed TTS), మీరు
{
"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"
}
నిర్మాణం రెడీ?
మీ API కీ పొందండి మరియు మీ అనువర్తనములు లోకి TTS.ai ప్రారంభించు.