API փաստաթղթեր
TTS.ai-ը ներառեք ձեր ծրագրերում մեր REST API-ի միջոցով։ OpenAI-ի հետ համընկնող ձևաչափ՝ հեշտ տեղափոխման համար։
Համապարփակ
TTS.ai API-ն ապահովում է ծրագրային մուտք դեպի պլատֆորմի բոլոր առանձնահատկությունները՝ տեքստից խոսքի սինթեզի, խոսքից տեքստի թարգմանության, ձայնի կլոնավորման, ձայնային բարելավման և այլն։ API-ն օգտագործում է ստանդարտ REST կոնվենցիաներ JSON խնդրանք/պատասխան մարմինների հետ։
API կոդ
Ձեր API կոդը ստանալ Հաշվի պարամետրեր. Ընկերության կառուցվածքը և գործունեությունը.
Հիմնական URL
https://api.tts.ai/v1/
Գործողություն
Օգտագործողի տեքստ Authorization գլխամաս
Ավտոմատացում
/v1/tts/ աշխատել առանց որևէ վկայագրման, մինչև 5000 կերպար/օր մեկ IP հասցեի համար, օգտագործելով մեր ցանկացած անվճար մոդել (piper, vits, melotts, kokoro). Գրանցվեք անվճար հաշիվ, որպեսզի ստանա 15,000 բոնուսային հերոսներ և հասանելիություն premium մոդելներին։
Premium մոդելների և ավելի բարձր տոկոսադրույքի սահմանների համար, ստուգեք հավաստիությունը Bearer token-ով Authorization գլխամաս.
Authorization: Bearer sk-tts-your-api-key-here
SDK- ներ
Առաջարկվող պաշտոնական SDK-ները հեշտացնում են TTS.ai-ը ձեր ծրագրի մեջ ներառելը։ Դրանք բաց կոդով են և հասանելի են 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
Բոլոր վերջնական կետերը հարաբերական են այս հիմնային URL- ին։ Օրինակ, TTS վերջնական կետ է՝
Չափի սահմանափակումներ
API արագության սահմանափակումները տարբերվում են պլանի համաձայն.
| Գործողություն | Պահանջներ/րոպե | Միաժամանակյա | Տեքստի առավելագույն երկարությունը |
|---|---|---|---|
| Ազատ | 10 | 2 | 500 սիմվոլ |
| Ընդունել | 30 | 3 | 1,000,000 քարտեր |
| Օգտագործող | 60 | 5 | 1,000,000 քարտեր |
| Ընկերություն | 300 | 20 | 50,000 սիմվոլներ |
Հաճախականության սահմանափակումը ներառված է յուրաքանչյուր պատասխանում: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
Ընդհանուր
| Ծառայություն | Գին | Յունուար |
|---|---|---|
| TTS (Ազատ մոդելներ՝ Piper, VITS, MeloTTS) | 1000 քարտեր | 1000 հիերոգլիֆ |
| TTS (Ստանդարտ մոդելներ: Kokoro, CosyVoice 2, և այլն) | 2,000 քարտեր | 1000 հիերոգլիֆ |
| TTS (Premium մոդելներ՝ Tortoise, Chatterbox և այլն) | 4,000 քարտեր | 1000 հիերոգլիֆ |
| Խոսքից տեքստName | 2,000 քարտեր | ձայնային րոպեական |
| Ձայնի կլոնավորում | 4,000 քարտեր | 1000 հիերոգլիֆ |
| Խոսքի փոխակերպիչ | 3,000 քարտեր | ձայնային րոպեական |
| Ձայնի բարելավում | 2,000 քարտեր | ձայնային րոպեական |
| Ձայնի հեռացում / ձայնի բաժանում | 3,000-4,000 այբուբեն | ձայնային րոպեական |
| Խոսքի թարգմանություն | 5,000 քարտեր | ձայնային րոպեական |
| Ձայնային զրույց | 3,000 քարտեր | յուրաքանչյուր հերթափոխի համար |
| Գործողություն | Ազատ | -- |
| Աուդիո փոխակերպիչ | Ազատ | -- |
Տեքստից խոսքName
Անվանել տեքստը ձայնային ձայնագրության։ Վերադարձնում է ձայնային ֆայլը պահանջված ձևաչափով։
Պահանջի մարմին
| Պարամետրեր | Տիպ | Պահանջվում է | Ապրանքանիշ |
|---|---|---|---|
| model | string | Ոչ | մոդելի ID-ն (օրինակ, kokoro, chatterbox, piper)։ Եթե բաց թողնվի, ապա մենք ինքնաբերաբար կառաջարկենք մոդել, որը աջակցում է խնդրվող լեզու-ին՝ kokoro en/ja/zh/ko/fr/de/it/pt/es/hi/ru, piper այլ աջակցվող լեզուների համար (ar/pl/nl/cs/da/fi/el/hu/tr/uk/vi/etc.)։ |
| text | string | Այո | Տեքստ, որը պետք է փոխակերպել խոսակցության։ Մեկ խնդրանքի համար սահմանված է 500 նշան (անանուն), 5000 (անվճար հաշիվ), 1,000,000 (վճարովի պլան)։ Ծանր մուտքագրումները սերվերի կողմից ինքնաբերաբար կբաժանվեն հատվածների։ |
| voice | string | Այո | Ձայնի ID (օգտագործեք /v1/voices/ հասանելի ձայների ցանկ կազմելու համար) |
| format | string | Ոչ | Էքսպորտային ձևաչափը` mp3 (լռելյայն), wav, flac, ogg |
| speed | float | Ոչ | Խոսելու արագության բազմապատկիչը։ Լռելյայն՝ 1.0։ Տարբերակ՝ 0.5-ից 2.0 |
| language | string | Ոչ | Լեզվի կոդը (օրինակ, hy, hy)։ Ավտոմատորեն հայտնաբերվում է, եթե բացակայում է։ |
| instructions | string | Ոչ | Աշխատող / մատուցման նշաններ (≤500 սիմվոլներ) օրինակ \ |
| pronunciations | object | array | Ոչ | Ըստ խնդրանքի արտասանությունը փոխարինում է. Կամ {\ |
| stream | boolean | Ոչ | Ընդունել հոսքի պատասխանը։ Լռելյայն՝ false |
Օրինակ
curl -X POST https://api.tts.ai/v1/tts/ \
-H "Authorization: Bearer sk-tts-your-key" \
-H "Content-Type: application/json" \
-d '{
"model": "kokoro",
"text": "Hello from TTS.ai! This is a test.",
"voice": "af_bella",
"format": "mp3"
}' \
--output output.mp3
SSML պիտակներ
Ցուցադրել թվերը, օրերը, արժույթը, հեռախոսահամարները և ակրոնիմները Լռելյայն օրվա ձևաչափը 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 mdy է անգլերենի համար և dmy այլ վայրերում; փոխարինել 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."
}Պատասխան
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.
Խոսքից տեքստName
Արտասանել ձայնային տվյալները տեքստային ձևով։ Պահպանում է 99 լեզու` ավտոմատ հայտնաբերման միջոցով։
Պահանջի մարմին (multipart/form-data)
| Պարամետրեր | Տիպ | Պահանջվում է | Ապրանքանիշ |
|---|---|---|---|
| file | file | Այո | Աուդիո ֆայլ (MP3, WAV, FLAC, OGG, M4A, MP4, WebM). Ավելին քան 100 Մբ |
| model | string | Ոչ | STT մոդել: whisper (լռելյայն), faster-whisper, sensevoice |
| language | string | Ոչ | Լեզվի կոդ. auto ավտոմատ հայտնաբերման համար (առաջադրված). |
| timestamps | boolean | Ոչ | Լռելյայն՝ false |
| diarize | boolean | Ոչ | Օգտագործել ձայնագրիչի օրացույցը։ Լռելյայն՝ false |
Պատասխան
{
"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 վայրկյան խորհուրդ է տրվում). Ավելի շատ 20 Մբ |
| text | string | Այո | Տեքստ, որը կլոնավորված ձայնով կխոսվի։ |
| model | string | Ոչ | Կլոնի մոդել՝ chatterbox (լռելյայն), cosyvoice2, gpt-sovits |
| format | string | Ոչ | Էքսպորտային ձևաչափը. mp3 (լավագույնը), wav, flac |
| language | string | Ոչ | Ցանկացած լեզվի կոդը: Պետք է աջակցվի ընտրված մոդելի կողմից: |
Պատասխան
Վերադարձնում է ձայնային ֆայլը որպես եռակի տվյալներ, նույնը, ինչ TTS վերջնական կետ
Խոսքի փոխակերպիչ
Ավտոմատ կերպով փոխակերպել ձայնային տվյալները այլ ձայնի պես հնչելու համար։ Տեղադրել սկզբնական ձայնային տվյալները և ընտրել նպատակային ձայնը։
Պահանջի մարմին (multipart/form-data)
| Պարամետրեր | Տիպ | Պահանջվում է | Ապրանքանիշ |
|---|---|---|---|
| file | file | Այո | Օդիո սկզբնական ֆայլը (MP3, WAV, FLAC). Ավելին քան 50 Մբ |
| target_voice | string | Այո | Փոխանակելու նպատակային ձայնային ID-ն (օգտագործեք /v1/voices/ հասանելի ձայների ցանկ կազմելու համար) |
| model | string | Ոչ | Ձայնի փոխակերպման մոդել՝ openvoice (լռելյայն), knn-vc |
| format | string | Ոչ | Էքսպորտային ձևաչափ՝ wav (լռելյայն), mp3, flac |
Օրինակ
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
Պատասխան
Վերադարձնում է փոխակերպված ձայնային ֆայլը որպես եռակի տվյալներ
Խոսքի թարգմանություն
Թարգմանել խոսված ձայնը մեկ լեզվից մյուսը։ Միավորում է խոսել-տեքստը, թարգմանել-տեքստը և տեքստը-խոսելը մեկ զանգի ընթացքում։
Պահանջի մարմին (multipart/form-data)
| Պարամետրեր | Տիպ | Պահանջվում է | Ապրանքանիշ |
|---|---|---|---|
| file | file | Այո | Օգտագործել սկզբնական լեզվով ձայնային ֆայլը։ Ավելի շատ 100 Մբ։ |
| target_language | string | Այո | Օգտագործվող լեզվի կոդը (օրինակ, hy, hy, hy, hy) |
| voice | string | Ոչ | Թարգմանության ելքի ձայնը։ Ավտոմատ ընտրվում է, եթե բացակայում է։ |
| preserve_voice | boolean | Ոչ | Փորձել պահպանել ձայնագրողի սկզբնական ձայնային հատկությունները։ Լռելյայն՝ false |
Պատասխան
{
"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 | Այո | Ծագման ձայնային ֆայլ. 50 Մբ առավելագույն. |
| voice | string | Այո | Ձայնի ելքի նպատակային ID- ը |
| model | string | Ոչ | Օրինակ՝ openvoice (լռելյայն), chatterbox |
| emotion | string | Ոչ | Նպատակային էմոցիա: neutral, happy, sad, angry, excited |
| speed | float | Ոչ | արագության կարգավորում. Լռելյայն՝ 1.0։ Տարբերակ՝ 0.5-ից 2.0 |
Պատասխան
Վերադարձնում է փոխակերպված ձայնային ֆայլը որպես եռակի տվյալներ
Աուդիո գործիքներ
Աուդիո վերամշակման վերջնական կետերը բարելավման, ձայնի հեռացման, սկավառակի բաժանման և այլն համար։
Բարձրացնել ձայնի որակը՝ նվազեցնելով աղմուկը, բարելավելով ճշգրտությունը, ավելացնելով լուսավորությունը։
| file file | Աուդիո ֆայլի բարելավում |
| denoise boolean | Անջատել աղմուկը (լռելյայն՝ ճիշտ) |
| enhance_clarity boolean | Բարձրացնել խոսքի հստակությունը (լռելյայն՝ ճիշտ) |
| super_resolution boolean | Ավտոմատ բարձրացնել ձայնի որակը (լռելյայն՝ false) |
| strength integer | 1-3 (թեթև, միջին, ուժեղ): Լռելյայն՝ 2 |
Ձայնայինների բաժանում նվագախմբայիններից (ձայնայինների հեռացում) կամ բաժանում սկավառակների մեջ.
| file file | Ավտոմատ կերպով ջնջել |
| model string | demucs (լռելյայն) կամ spleeter |
| stems integer | Ծաղիկների քանակը 2, 4, 5 կամ 6 (լռելյայն՝ 2) |
| format string | Ընտրեք ելքի ձևաչափը. wav, mp3, flac |
Հեռացնել ձայնագրություններից հնչյունները և հնչյունափոխությունը։
| 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 | Օգտագործվող ձևաչափեր՝ mp3, wav, flac, ogg, m4a, aac |
| bitrate integer | Ընտրեք ելքի բիթերի քանակը` kbps- ով: 64, 128, 192, 256, 320 |
| sample_rate integer | Օրինակների քանակը՝ 22050, 44100, 48000 |
| channels string | mono կամ stereo |
Ձայնային զրույց
Ավտոմատ ձայնային կամ տեքստային հաղորդագրություն ուղարկել և ստանալ սինթետիկ ձայնային պատասխան։
Պահանջի մարմին (multipart/form-data կամ JSON)
| Պարամետրեր | Տիպ | Պահանջվում է | Ապրանքանիշ |
|---|---|---|---|
| audio | file | Ոչ* | Աուդիո մուտք (պահանջվում է audio կամ text) |
| text | string | Ոչ* | Տեքստային մուտք (պահանջվում է audio կամ text) |
| voice | string | Ոչ | AI-ի պատասխանի ձայնը։ Լռելյայն՝ af_bella |
| tts_model | string | Ոչ | TTS մոդելը պատասխանի համար։ Լռելյայն՝ kokoro |
| 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 խմբաքանակ
Տեղադրել մի քանի տեքստեր զուգահեռ TTS ստեղծման համար։ Առաջարկվում է webhook- ի հետազոտություն ստանալ, երբ բոլոր աշխատանքները ավարտվել են։
Պարամետրեր
| Փարամետրի ցուցակ | Տիպ | Ապրանքանիշ |
|---|---|---|
| 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/batch/result/?batch_id=abc123-ով հարցման ընթացքը
Ձայնի ներկառուցում
Հետևյալ ձայնային կլոունավորման խնդրանքներում օգտագործել վերադարձված embed_id-ը` մոտավորապես ակնթարթային գեներացիայի համար։
Պարամետրեր
| Փարամետրի ցուցակ | Տիպ | Ապրանքանիշ |
|---|---|---|
| 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 | Ֆիլտրել ըստ մոդելի ID-ի (օրինակ, kokoro) |
| language | string | Ֆիլտրել լեզվի կոդով (օրինակ, hy) |
| gender | string | Ֆիլտրել ըստ սեռի: male, female, neutral |
Պատասխան
{
"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
}
Ցուցադրել վերնագրերը նոր
Ծննդաբերել սինխրոնացված ենթատեքստեր ցանկացած ավարտված TTS աշխատանքի համար։ Աշխատեցնում է Whisper ուղղահայացությունը ձայնի վրա և վերադարձնում SRT կամ WebVTT։ Արդյունքը պահվում է սկավառակի վրա, այնպես որ նույն uuid- ի համար երկրորդ կոչը սկավառակի կարդում է։
Պարամետրեր
| Պարամետրեր | Պահանջվում է | Ապրանքանիշ |
|---|---|---|
| uuid | Այո | UUID-ը վերադարձվել է /v1/tts/ կամ /v1/voice-clone/-ի կողմից։ |
| format | Ոչ | srt (առաջին) կամ vtt. |
| download | Ոչ | 1 Content-Disposition: attachment ուղարկել, որպեսզի բրաուզերը պահպանի, այլ ոչ թե ցույց տա. |
| language | Ոչ | Հուշում ուղղահայաց մոդելի մասին (ավտոմատորեն հայտնաբերվում է, եթե բացակայում է) |
curl "https://api.tts.ai/v1/speech/subtitles/?uuid=$UUID&format=srt&download=1" -o subtitles.srt
Արտասանության բառարան նոր
Տեսագրության արտասանության համակարգին ասել, թե ինչպես արտասանել որոշակի բառերը։ Ստեղծված գրառումները ինքնաբերաբար կիրառվում են ձեր կատարած յուրաքանչյուր գրառումին։ 200 գրառում յուրաքանչյուր հաշվի համար։
Պահանջի մարմին (POST)
| Պարամետրեր | Տիպ | Ապրանքանիշ |
|---|---|---|
| word | string | Անջատելու համար բառ (օրինակ՝ GIF, Anthropic)։ Բառի սահմանը համընկնում է։ |
| replacement | string | Օրինակ՝ jiff, ann THROP ick, ick, ick, ick, ick, ick, ick, ick։ |
| language | string | ISO կոդը` բացառիկ: Թափանցիկ = կիրառվում է բոլոր լեզուների համար: |
| case_sensitive | boolean | Լռելյայն false. Հաշվի առնել տառատեսակը, երբ 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-..."
Դուք կարող եք նաև անցնել per-պահանջը overrides առանց պահպանելու նրանց — ներառել արտասանությունները ցանկացած /v1/tts/ կոչը, ինչպես օբյեկտ կամ ռեժիմ (տես TTS endpoint params).
Աղբյուրի նկարագրություն նոր
Ցանկացած հոդվածի էջում տեգը տեղադրելուց հետո այցելուները կստանան ընթերցիչների համար նախատեսված ցուցակ, որը կպատմի հոդվածի մասին։ Ավտոմատորեն հայտնաբերում է հոդվածի մարմինը, աջակցում է ձայնի / մոդելի / դիրքի / շեշտադրման գույնին։
<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-tts-…): Դոմենի սահմանափակումները կիրառվում են allowed_domains դաշտում: |
data-voice | Ձայնային ճանաչողական ցուցանիշ. Լռելյայն af_bella։ |
data-model | TTS մոդելի ID-ն: Լռելյայն kokoro։ |
data-extract | auto (լռելյայն) — փորձում է article/main/.post-content/.entry-content ընտրողները, վերադառնում է ամենախոշոր կետի խմբին։ Կամ էլ CSS ընտրողը փոխանցում է որոշակի տարրերի ուղղման համար։ |
data-position | bottom (լռելյայն) կամ top. |
data-color | Ակցիոն գույնը (յուրաքանչյուր CSS գույն)։ Լռելյայն #e60000։ |
data-min-chars / data-max-chars | Չեղարկել սլաքը, եթե հոդվածը կարճ է քան min-characters (լռելյայն 200)։ Սահմանել մուտքագրման չափը max-characters-ի վրա (լռելյայն 50,000)։ |
Տեսանյութի մոդուլ
Ընդգրկված կոճակների կերպարով ներկառուցված. Ներկայացնում է բառի կողքին և նվագում է կոճակի ակտիվացմամբ ստեղծված կարճ հատվածը։ Հատուկ ձև է վերևում նշված հոդվածի պատմողից (որն ինքնաբերաբար ներարկում է էջը ծածկող վահանակ և պատմում է ամբողջ հոդվածը)։
<script src="https://tts.ai/widget.js"
data-voice="af_bella"
data-model="kokoro"
data-style="full"
data-theme="light"></script>
Ստեղծված ձայներ (կշռադատված կլոուններ)
Առաջարկված ձայնային տվյալները մի անգամ ներբեռնել, վերադարձնել voice_id-ը, ապա ներբեռնել այդ id-ը TTS-ի պահանջներում, փոխարենը ձայնային տվյալները վերբեռնելու համար ամեն անգամ զանգելիս։ Լավագույն տարբերակը բարձր ձայնային ինտեգրման համար։
Տեղադրել ձայն
POST
https://tts.ai/api/v1/user-voices/
Պահանջվում է ավտոմատացում
Բազմամասնային ձև. Լանդշաֆտներ՝ ֆայլ (պահանջվում է, 5-30 վայրկյան ձայն), անուն (պահանջվում է), լեզու (առաջարկվում է, լռելյայն en), մոդել (առաջարկվում է — ինքնաշարժ ընտրում է cosyvoice2 zh/ja/ko համար, այլ դեպքում openvoice), consent_confirmed (պահանջվում է, ցանկացած ճշմարիտ արժեք)
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- ում
POST /api/v1/tts/ (ԱՅՍՏԵՂԱՆՔ՝ web VPS սերվեր, ոչ թե api.tts.ai) user_voice_id-ով։ Մենք բեռնում ենք ձեր պահպանված ձայնը և ուղարկում կլոունինգի ալիք։
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
Արխիվացնել / վերակենդանացնել (անվճար)
Արխիվացված ձայները մնում են ձեր հաշվին, բայց չեն կարող օգտագործվել TTS-ում։ Կարևոր է հանգիստ վերջնական օգտագործողների համար, որպեսզի ձեր ցանկը մաքուր մնա։
POST https://tts.ai/api/v1/user-voices/uv_a1b2c3d4e5f6/archive/
POST https://tts.ai/api/v1/user-voices/uv_a1b2c3d4e5f6/reactivate/
Կոդի օրինակներ
Տեքստից խոսքName
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')}")
Խոսքից տեքստName
# 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)
Տեքստից խոսքName
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();
Խոսքից տեքստName
// 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);
Տեքստից խոսքName
# 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
Խոսքից տեքստName
# 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
Սխալի կոդեր
Բոլոր սխալները ետ են տալիս JSON պատասխան՝ error դաշտ
{
"error": {
"code": "insufficient_credits",
"message": "You do not have enough characters for this request.",
"characters_required": 4000,
"characters_available": 2000
}
}
| HTTP վիճակ | Սխալի կոդ | Ապրանքանիշ |
|---|---|---|
| 400 | bad_request |
Անտեղի պահանջված պարամետրեր: Դիտեք սխալի հաղորդագրությունը մանրամասների համար: |
| 401 | unauthorized |
Հաշվառված կամ օրինական API կոդը բացակայում է։ |
| 402 | insufficient_credits |
Չափազանց քիչ հերոսներ: Գնացեք /pricing/ կայք և գնեք ավելին: |
| 403 | forbidden |
Դուք չունեք այս ռեսուրսին հասնելու իրավունք (օրինակ՝ այլ օգտատիրոջ աշխատանքը հարցումով ստուգելու իրավունք)։ API-ի հասանելիությունը ներառված է յուրաքանչյուր պլանում։ |
| 404 | not_found |
մոդել կամ ձայն չի հայտնաբերվել։ |
| 413 | file_too_large |
Փոխադրված ֆայլը գերազանցում է չափսի սահմանը։ |
| 429 | rate_limited |
Անհրաժեշտից շատ խնդրանքներ. Ստուգեք արագության սահմանափակումների գլխամասերը: |
| 500 | internal_error |
Սերվերի սխալ. Փորձեք կրկին ավելի ուշ։ |
| 503 | model_loading |
Տեսակը բեռնվում է։ Պարզապես փորձեք մի քանի վայրկյան հետո։ |
Webhooks- ներ
Երկարաժամկետ գործողությունների համար (stamp-ի բաժանում, batch TTS), դուք կարող եք տրամադրել webhook_url պարամետրը։ Երբ գործողությունը ավարտվել է, մենք կտեղադրենք արդյունքը ձեր 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"
}
Պատրաստ եք կառուցելու համար?
Ստացեք ձեր API կոդը և սկսեք ինտեգրել TTS.ai-ը ձեր ծրագրերում։