API پۈتۈكلىرى

REST API ئارقىلىق TTS.ai نى پروگراممىلىرىڭىزغا بىرلەشتۈرۈڭ. OpenAI-غا ماس كېلىدىغان شەكىلدە ئاسان كۆچۈرۈلىدۇ.

REST API OpenAI بىلەن ماسلىشىدۇ JSON جاۋابى سۈرەتكە ئېلىشنى قوللايدۇ

ئومۇمىي كۆرۈنۈش

TTS.ai API پۈتۈن پلاتفورمىنىڭ ئىقتىدارلىرىغا پروگرامما ئارقىلىق ئېرىشىشكە ياردەم بېرىدۇ: تېكىستتىن سۆزگە بىرىكتۈرگۈچ، سۆزدىن تېكىستكە تەرجىمە قىلغۇچ، ئاۋازنى كۆچۈرۈش، ئاۋازنى كۈچەيتىش، ۋە باشقا. API JSON تەلەپ/جاۋاب ئورگانلىرى بىلەن REST كونۋېنسىيىسىنى ئىشلىتىدۇ.

API ئاچقۇچى

API ئاچقۇچىڭىزنى ئېلىش ھېسابات تەڭشىكى. Pro ۋە Enterprise پروگراممىلىرىدا قوللىنىلىدۇ.

ئاساسىي URL

https://api.tts.ai/v1/

ھوقۇق

يەتكۈزگۈچ توكى ئارقىلىق Authorization باشلىق

تونۇشتۇرۇش

سىزنى كۈتۈۋاتىمەن، سىزنى كۈتۈۋاتىمەن. نامسىز POST لارنى يوللايدۇ /v1/tts/ بىزنىڭ ھەقسىز تىپلىرىمىزنى ئىشلىتىپ، ھەر بىر IP نىڭ كۈندە 5000 ھەرپىگە قەدەر، ھېچقانداق ئىجازەتسىز ئىشلەيسىز (piper, vits, melotts, kokoro). 15000 گە يېقىن بوۋاقنىڭ كىملىكىنى ۋە قىممەتلىك مەشغۇلاتلارنى ئېلىش ئۈچۈن ھەقسىز ھېسابات قۇرۇشقا رۇخسەت قىلىمىز.

ھەممىلا API تەلەپلىرى بىر Bearer token ئارقىلىق ئىجازەت بېرىشنى تەلەپ قىلىدۇ Authorization باشلىق.

HTTP باشلىقى
Authorization: Bearer sk-tts-your-api-key-here
API ئاچقۇچىڭىزنى يوشۇرۇن تۇتۇڭ. ئۇنى خېرىدار تەرەپ كودى، ئومۇمىي ساقلىغۇچ ياكى خاتىرە بىلەن ئورتاقلاشماڭلار. ھېساباتىڭىزدىكى تەڭشەكلەردىن ئاچقۇچلارنى دائىم ئايلاندۇرۇپ تۇرۇڭ.

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")
GitHub

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');
GitHub

ئاساسىي URL

ئاساسىي URL: https://api.tts.ai/v1/

بارلىق ئاخىرلاشتۇرۇش نۇقتىلىرى بۇ ئاساسلىق URL بىلەن مۇناسىۋەتلىك. مەسىلەن، TTS ئاخىرلاشتۇرۇش نۇقتىسى:

POST https://api.tts.ai/v1/tts/

سۈرئەتنىڭ چەكلىمىلىرى

API سۈرئىتىنىڭ چەكلىمىلىرى پىلانى بويىچە ئۆزگىرىپ تۇرىدۇ:

پىلان تەلەپ/مىنۇت بىر ۋاقىتتا ئەڭ چوڭ تېكىست ئۇزۇنلۇقى
بوش 10 2 500 ھەرپ
باشلىغۇچى 30 3 1000000 ھەرپ
كەسپىي 60 5 1000000 ھەرپ
شىركەت 300 20 50000 ھەرپ

ھەربىر جاۋابتا سۈرئەتنىڭ چەكلىمىسىگە ئائىت باشلىقلار بار: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

قەرز ھەققى

خىزمەت قىممەت بىرلىك
TTS (ئوچۇق مودېل: Piper، VITS، MeloTTS) 1 نومۇر ھەر 1000 ھەرپ ئۈچۈن
TTS (ستاندارت نۇسخىلىرى: Kokoro، CosyVoice 2، قاتارلىقلار) 2 نومۇر ھەر 1000 ھەرپ ئۈچۈن
TTS (باھالىق نۇسخىلار: Tortoise، Chatterbox، قاتارلىقلار) 4 نومۇر ھەر 1000 ھەرپ ئۈچۈن
سۆزدىن مەزمۇنغا 2 نومۇر ھەر مىنۇتتا ئاۋاز
ئاۋازنى كۆچۈرۈش پروگراممىسى 4 نومۇر ھەر 1000 ھەرپ ئۈچۈن
ئاۋاز ئۆزگەرتكۈچ 3 نومۇر ھەر مىنۇتتا ئاۋاز
ئاۋازنى ياخشىلاش 2 نومۇر ھەر مىنۇتتا ئاۋاز
ئاۋازنى چىقىرىۋېتىش / ئاۋازنى بۆلۈش 3-4 نومۇر ھەر مىنۇتتا ئاۋاز
سۆز تەرجىمە 5 نومۇر ھەر مىنۇتتا ئاۋاز
ئاۋازلىق سۆھبەت 3 نومۇر ھەر قېتىمدا
ئاچقۇچ ۋە BPM ئىزلىگۈچ بوش --
ئاۋاز ئايلاندۇرغۇچ بوش --

تېكىستتىن سۆزگە

POST /v1/tts/

تېكىستنى ئاۋازغا ئايلاندۇرۇش پروگراممىسى. تەلەپ قىلىنغان پىچىمدىكى ئاۋاز ھۆججىتىنى قايتۇرىدۇ.

تەلەپ ماۋزۇسى

پارامېتىرلارتۈرچوقۇمچۈشەندۈرۈش
model string ئۇنداق ئەمەس مودېل ID (مەسىلەن kokoro، chatterbox، piper)
text string ھەئە سۆزگە ئايلاندۇرىدىغان تېكىست (Pro دىكى ئەڭ كۆپ 5000 ھەرپ، Enterprise دىكى ئەڭ كۆپ 50000 ھەرپ)
voice string ھەئە ئاۋاز ID (/v1/voices/ نى ئىشلىتىپ قوللىنىلىدىغان ئاۋازلارنى تىزىملاش)
format string ئۇنداق ئەمەس چىقىرىش پىچىمى: mp3 (قەدەملىك)، wav، flac، ogg
speed float ئۇنداق ئەمەس سۆزلەش تېزلىكىنىڭ كۆپەيتكۈچىسى. كۆڭۈلدىكى: 1.0. دائىرىسى: 0.5 دىن 2.0 گىچە
language string ئۇنداق ئەمەس تىل كودى (مەسىلەن، en، es). ئەگەر قالدۇرۇلسا ئاپتوماتىك بايقايدۇ.
instructions string ئۇنداق ئەمەس مەشغۇلات / تەمىنلەش ئۇچۇرلىرى (≤500 ھەرپ). مەسىلەن \
pronunciations object | array ئۇنداق ئەمەس ھەربىر تەلەپ بويىچە سۆزلەشنى ئالماشتۇرىدۇ. {\
stream boolean ئۇنداق ئەمەس سۈرئەتلىك جاۋابنى قوزغىتىش. كۆڭۈلدىكى: false

مەسىلە تەلەپ قىلىش

cURL
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 نىڭ چەكلىمىلىرى

سانلارنى، كۈندىلىكلەرنى، پۇلنى، تېلېفون نومۇرلىرىنى ۋە قىسقارتمىلارنى

چۈشەندۈركىرگۈزگۈچسۆزلەنگەن
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."
}

جاۋاب

The TTS endpoint queues your request and returns a JSON response with a job UUID. You then poll for the result.

Step 1: Submit request

Response (JSON)
{
  "uuid": "77b71db532874ce98e84a69a2d740d4c",
  "job_id": "f21316bb-aefa-480d-8523-701d1e3184ce",
  "status": "queued",
  "credits_used": 11,
  "credits_remaining": 15000
}

Step 2: Poll for result

GET /v1/speech/results/?uuid=<job_uuid>

Poll this endpoint every 1-2 seconds until status is completed or failed.

Polling response (completed)
{
  "status": "completed",
  "result_url": "https://api.tts.ai/static/downloads/77b71db5.../output.mp3"
}
Polling response (still processing)
{
  "status": "processing"
}

Step 3: Download audio

Fetch the result_url from the completed response to download the audio file.

Full example

Python
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)

Streaming alternative: For supported models (Kokoro, MeloTTS), use POST /v1/tts/stream/ for real-time Server-Sent Events (SSE) streaming — no polling needed.

سۆزدىن مەزمۇنغا

POST /v1/stt/

ئاۋازنى تېكىستكە ئايلاندۇرۇش پروگراممىسى. 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

جاۋاب

JSON جاۋابى
{
  "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"
    }
  ]
}

ئاۋازنى كۆچۈرۈش پروگراممىسى

POST /v1/tts/clone/

سۈرەتكە ئېلىنغان ئاۋازدا سۆزلەشنى ھاسىل قىلىش پروگراممىسى. ئاۋاز ۋە تېكىستنى كۆچۈرۈش پروگراممىسى

تەلەپ ماۋزۇسى (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 ئاخىرلاشتۇرۇش نۇقتىسى بىلەن ئوخشاش.

ئاۋاز ئۆزگەرتكۈچ

POST /v1/voice-convert/

ئاۋازنى باشقا ئاۋازغا ئايلاندۇرۇش پروگراممىسى. مەنبە ئاۋازنى چۈشۈرۈپ، مەقسەت ئاۋازنى تاللاڭ.

تەلەپ ماۋزۇسى (multipart/form-data)

پارامېتىرلارتۈرچوقۇمچۈشەندۈرۈش
file file ھەئە مەنبە ئۈن ھۆججىتى (MP3، WAV، FLAC). ئەڭ كۆپ 50MB.
target_voice string ھەئە ئايلاندۇرۇشقا تېگىشلىك ئاۋازنىڭ ئىسمى (/v1/voices/ نى ئىشلىتىپ قوللىنىلىدىغان ئاۋازلارنى تىزىپ چىقىرىڭ)
model string ئۇنداق ئەمەس ئاۋاز ئۆزگەرتىش مودېلى: openvoice (قەدەملىك)، knn-vc
format string ئۇنداق ئەمەس چىقىرىش پىچىمى: wav (قەدەملىك)، mp3، flac

مەسىلە تەلەپ قىلىش

cURL
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

جاۋاب

ئۆزگەرتىلگەن ئۈن ھۆججىتىنى ئىككىلىك سانلىق-مەلۇمات شەكلىدە قايتۇرىدۇ.

سۆز تەرجىمە

POST /v1/speech-translate/

سۆزلەنگەن ئاۋازنى بىر تىلدىن يەنە بىر تىلغا تەرجىمە قىلىش پروگراممىسى. سۆزدىن تېكىستكە، تەرجىمەدىن تېكىستكە ۋە تېكىستتىن سۆزگە بىرلەشتۈرىدۇ.

تەلەپ ماۋزۇسى (multipart/form-data)

پارامېتىرلارتۈرچوقۇمچۈشەندۈرۈش
file file ھەئە مەنبە ئاۋاز ھۆججىتى. ئەڭ چوڭ چوڭلۇقى 100 مېگابايت.
target_language string ھەئە نىشان تىل كودى (مەسىلەن es، fr، de، ja)
voice string ئۇنداق ئەمەس تەرجىمە قىلىش ئۈچۈن ئىشلىتىلىدىغان ئاۋاز. ئەگەر قالدۇرۇلسا ئاپتوماتىك تاللىنىدۇ.
preserve_voice boolean ئۇنداق ئەمەس ئەسلى ئاڭلىغۇچىنى ساقلاشنى سىنايدۇ

جاۋاب

JSON جاۋابى
{
  "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
}

سۆزدىن سۆزگە

POST /v1/speech-to-speech/

سۆزلەش ئۇسلۇبى، ھېسسىيات، ياكى يەتكۈزۈش ئۇسۇلىنى ئۆزگەرتىش، ئەمما مەزمۇننى ساقلاش. ئاۋازنى تەڭشەش، تېزلىكنى تەڭشەش ۋە ئىپادىلەشكە پايدىلىق.

تەلەپ ماۋزۇسى (multipart/form-data)

پارامېتىرلارتۈرچوقۇمچۈشەندۈرۈش
file file ھەئە مەنبە سۆزلەش ئاۋاز ھۆججىتى. ئەڭ چوڭ 50MB.
voice string ھەئە ئاۋاز چىقىرىش ئۈچۈن مەقسەت ئاۋاز ID
model string ئۇنداق ئەمەس تىپ: openvoice (قەدەملىك)، chatterbox
emotion string ئۇنداق ئەمەس مەقسەتلىك ھېسسىيات: تەرەپسىز، خۇشال، ھەسرەتلىك، ئاڭغۇر، خۇشال
speed float ئۇنداق ئەمەس تېزلىك تەڭشەش. كۆڭۈلدىكى: 1.0. دائىرىسى: 0.5دىن 2.0غىچە

جاۋاب

ئۆزگەرتىلگەن ئۈن ھۆججىتىنى ئىككىلىك سانلىق-مەلۇمات شەكلىدە قايتۇرىدۇ.

ئاۋاز قورالى

ئاۋازنى ياخشىلاش، ئاۋازنى چىقىرىۋېتىش، ئاۋازنى پارچىلاش ۋە باشقا ئىشلار ئۈچۈن ئاۋازنى تەھرىرلىگۈچ.

POST /v1/audio/enhance/

ئاۋازنىڭ سۈپىتىنى ئۆستۈرىدۇ: ئاۋازنى ئاجىزلاشتۇرىدۇ، ئېنىقلىقىنى ئاشۇرىدۇ، ئېنىقلىقىنى يۇقىرى كۆتۈرىدۇ.

file fileكۈچەيتىدىغان ئۈن ھۆججىتى
denoise booleanئاۋازنى يوقىتىشنى مەشغۇلاتقا كىرگۈزىدۇ (قەدەملىگۈچ: true)
enhance_clarity booleanسۆزنى ئاڭلىتىشنى ياخشىلاش (قەدەملىك: راست)
super_resolution booleanئۈننىڭ سۈپىتىنى ئۆستۈرىدۇ (قەدەملىك: خاتا)
strength integer1-3 (ئاچچىق، ئوتتۇرا، قاتتىق). كۆڭۈلدىكى: 2
POST /v1/audio/separate/

ئاۋازلىق سۆزلەرنى ئاۋازسىز سۆزلەر بىلەن ياكى ئاۋازلىق سۆزلەرنى ئاۋازسىز سۆزلەر بىلەن ئايرىۋېتىش.

file fileئايرىلىدىغان ئۈن ھۆججىتى
model stringdemucs (مەۋھۇم) ياكى spleeter
stems integerقەدەم سانى: 2، 4، 5 ياكى 6 (قەدەم سانى: 2)
format stringچىقىرىش پىچىمى: wav، mp3، flac
POST /v1/audio/dereverb/

ئاۋاز خاتىرىلىگۈچتىن ئېقىش ۋە قايتا ئاۋازنى چىقىرىۋېتىش پروگراممىسى

file fileبىر تەرەپ قىلىنىدىغان ئۈن ھۆججىتى
type stringecho or reverb (default: both)
intensity integer1-5 (default: 3)
POST /v1/audio/analyze/ بوش

ئاۋازنى تەھلىل قىلىپ، ئاۋاز، 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"]
}
POST /v1/audio/convert/ بوش

ئۈننى پىچىملەر ئارىسىدا ئايلاندۇرۇش پروگراممىسى.

file fileئايلاندۇرىدىغان ئۈن ھۆججىتى
format stringنىشان پىچىم: mp3، wav، flac، ogg، m4a، aac
bitrate integerچىقىرىش بىيت سۈرئىتى (كىلوبىتس) 64، 128، 192، 256، 320
sample_rate integerتەكشۈرۈش نىسبىتى: 22050، 44100، 48000
channels stringmono ياكى stereo

ئاۋازلىق سۆھبەت

POST /v1/voice-chat/

ئاۋازنى ياكى تېكىستنى ئەۋەتىپ ئالماشتۇرۇلغان سۆز بىلەن AI جاۋابىنى ئېلىش پروگراممىسى

تەلەپ ماۋزۇسى (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 ئۇنداق ئەمەس بار سۆزلىشىشنى داۋاملاشتۇرۇش

جاۋاب

JSON جاۋابى
{
  "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 توپلاش

POST /v1/tts/batch/

بىر قانچە تېكىستنى تەڭشەك TTS ياساش ئۈچۈن يوللايدۇ. بارلىق ئىشلار تاماملانغاندا webhook نىڭ قايتا چاقىرىشىنى قوبۇل قىلىشنى تاللايدۇ.

پارامېتىرلار

پارامېتىرلارتۈرچۈشەندۈرۈش
textsarrayArray of objects: {text, model, voice}. Max 50 items.
webhook_urlstringOptional URL to POST results when batch completes.

جاۋاب

JSON جاۋابى
{
  "batch_id": "abc123",
  "total": 3,
  "completed": 0,
  "status": "processing"
}

GET /v1/tts/batch/result/ بىلەن سوراقنىڭ ئىلگىرىلىشى

ئاۋازنى كىرگۈزۈش

POST /v1/voice-embed/

ئاۋازنى يىغىنچاقلاش ئۈنىدىن ئالدىن ھېسابلاپ چىقىرىدۇ. كېيىنكى ئاۋازنى تەقلىدلەش تەلەپلىرىدە embed_id نى ئىشلىتىپ، دەل ۋاقتىدا ياسايدۇ.

پارامېتىرلار

پارامېتىرلارتۈرچۈشەندۈرۈش
filefileReference audio file (WAV, MP3, FLAC).
modelstringCloning model (default: chatterbox). Supported: chatterbox, cosyvoice2, openvoice, gpt-sovits, spark, indextts2, qwen3-tts.

جاۋاب

JSON جاۋابى
{
  "embed_id": "emb_abc123",
  "model": "chatterbox",
  "duration_ms": 450
}

ساغلاملىق تەكشۈرۈش

GET /v1/health/

GPU مۇلازىمېتىرىنىڭ ھالىتىنى، يۈكلەنگەن مودىللارنى ۋە كۈتۈش قاتارىنىڭ چوڭلۇقىنى تەكشۈرىدۇ. ئىجازەت بېرىش تەلەپ قىلىنمايدۇ. 30 سېكۇنت ئىچىدە قالدۇرۇلغان.

جاۋاب

JSON جاۋابى
{
  "status": "online",
  "latency_ms": 45,
  "queue_size": 3,
  "models_loaded": ["kokoro", "chatterbox", "cosyvoice2"]
}

تىپلار تىزىمى

GET /v1/models/

پۈتۈن قوللىنىلىدىغان مودېللار ۋە ئۇلارنىڭ ئىقتىدارلىرىنىڭ تىزىمىنى قايتۇرىدۇ.

جاۋاب

JSON جاۋابى
{
  "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
    }
  ]
}

ئاۋازلار تىزىمى

GET /v1/voices/

پۈتۈن قوللىنىلىدىغان ئاۋازلارنىڭ تىزىمىنى قايتۇرۇپ بېرىدۇ، بەلكىم تىل ياكى مودېل بويىچە سۈزۈپ چىقىرىدۇ.

سوئال پارامېتىرلىرى

پارامېتىرلارتۈرچۈشەندۈرۈش
model string مودېل ID بويىچە سۈزگۈچ (مەسىلەن kokoro)
language string تىل كودى بويىچە سۈزگۈچ(مەسىلەن en)
gender string جىنس بويىچە سۈزگۈچ: male، female، neutral

جاۋاب

JSON جاۋابى
{
  "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) يېڭى

GET /v1/speech/subtitles/?uuid=<job_uuid>&format=srt|vtt&download=1

ھەر قانداق تولۇقلانغان TTS ئىشلىرى ئۈچۈن تەڭشەلگەن قىستۇرمىلارنى ھاسىل قىلىدۇ. ئاۋاز ئۈستىدە Whisper تۈزلەشنى ئېلىپ بېرىپ SRT ياكى WebVTT نى قايتۇرىدۇ. نەتىجە دىسكىغا كۆچۈرۈلىدۇ، شۇڭا ئوخشاش uuid ئۈچۈن ئىككىنچى قېتىملىق چاقىرغاندا دىسكىنى ئوقۇش بولىدۇ.

سوئال پارامېتىرلىرى

پارامېتىرلارچوقۇمچۈشەندۈرۈش
uuidھەئە/v1/tts/ ياكى /v1/voice-clone/ نىڭ قايتۇرغان UUID نى كۆرسىتىدۇ.
formatئۇنداق ئەمەسsrt (ئۆزگەرتىلگەن) ياكى vtt.
downloadئۇنداق ئەمەس1 Content-Disposition: attachment نى ئەۋەتىش ئۈچۈن، شۇڭا كۆرگۈ كۆرسەتمىگە قارىغاندا ساقلايدۇ.
languageئۇنداق ئەمەستۈزلەش مودېلىنىڭ ئىزاھاتى (ئەگەر قويۇپ قويۇلغان بولسا ئاپتوماتىك بايقالغان).
cURL
curl "https://api.tts.ai/v1/speech/subtitles/?uuid=$UUID&format=srt&download=1" -o subtitles.srt

ئىپادىلەش لۇغىتى يېڭى

GET POST DELETE /api/v1/pronunciations/

TTS نىڭ قانداق سۆزلەرنى سۆزلەشنى ئېيتىش. ساقلانغان كىرگۈزگۈچلەرنى ھەربىر TTS تەلەپىڭىزگە ئاپتوماتىك ئىشلىتىش. ھەربىر ھېساباتتا 200 كىرگۈزگۈچنىڭ چەكلىمىسى بار.

تەلەپ ماۋزۇسى (POST)

پارامېتىرلارتۈرچۈشەندۈرۈش
wordstringئالماشتۇرىدىغان سۆز (مەسىلەن GIF، Anthropic). سۆزنىڭ چېگرىسى ماس كېلىدۇ.
replacementstringبۇنى قانداق يېزىش كېرەك؟ (مەسىلەن jiff، ann THROP ick).
languagestringISO كودى تاللاش. بوش = بارلىق تىللارغا ماس كېلىدۇ.
case_sensitivebooleanfalse نى كۆزدە تۇتۇش. true بولسا چوڭ-كىچىكلىكنى دەل مۇۋاپىقلاشتۇرىدۇ.
cURL
# 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/ چاقىرىشتا pronunciations نى مەھسۇلات ياكى ئارتىس (TTS ئاخىرقى نۇقتىسى پارامېتىرلىرىنى كۆرۈڭ) قىلىپ قوبۇل قىلىڭ.

ماقالە سۆزلىگۈچ يېڭى

ھەرقانداق ماقالە بەتلىرىگە