نوسراو بۆ قسەکردن ئاژانس مۆسیقا دەنگ بۆ نوسراو دووبارە دروستکردنی دەنگی دیزاینی دەنگی بازاڕ زیاتر
ڕاپۆرتکردنی کێشە/ داواکاری تایبەتمەندی

بەڵگەنامەکان

TTS.ai لە پرۆگرامەکانتدا بە بەکارهێنانی REST API دابمەزرێنە. فۆرمی هاوشێوەی OpenAI بۆ گواستنەوەی ئاسان.

REST ئەپی ئای پی پەرەپێدەری OpenAI وەڵامەکانی JSON پشتگیری ڕەوانەکردن

سەرنجدان

TTS.ai API ڕێگە بە پرۆگرامەکان دەدات بۆ هەموو تایبەتمەندییەکانی پڕۆگرامەکە: تێکست بۆ گفتوگۆ، گفتوگۆ بۆ نوسینی نوسراو، دووبارە دروستکردنی دەنگ، زیادکردنی دەنگ، و زیاتر.

کلیلی API

کلیلی ئەپی پی وەرگرە لە ڕێکخستنەکانی هەژمار. لە پلانەکانی Pro و Enterprise دا بەردەستە.

ماڵپەڕی بنەڕەتی

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

مۆڵەتدان

نیشانەی هەڵگر لە ڕێگەی Authorization سەرنووس

دڵنیابوونەوە

پلەی ئازاد - هیچ کلیلێک پێویست ناکات نادیار /v1/tts/ کاربکە بەبێ هیچ ئیمزایەک، تا ٥٠٠٠ هێما/ڕۆژ بۆ هەر ئای پییەک، بە بەکارهێنانی هەریەک لە مۆدێلەکانی خۆمان (piper, vits, melotts, kokoro). بۆ تۆمارکردنی حسابێکی بێ پارە بۆ بەدەستهێنانی 15,000 کاراکتەر و گەیشتن بە مۆدێلی پێشکەشکراو.

هەموو داواکاریەکانی ئەپی بی ئی پێویستیان بە ناساندن هەیە لە ڕێگەی نیشانەی بارکەرەوە لە Authorization سەرنووس.

سەرنووسەری HTTP 
Authorization: Bearer sk-tts-your-api-key-here
کلیلی API ی خۆت بپارێزە بەشدار مەکە لە کۆدەکانی لای کڕیار، پارێزگەی گشتی، یان تۆمارەکان. بە شێوەیەکی ئاسایی کلیلەکان بگۆڕە لە ڕێساکانی هەژمارەکەتەوە.

SDKs

TTS.ai بە ئاسانی دەخاتە ناو پرۆگرامەکەتەوە. هەردووکیان سەرچاوەی کراوەن و لە گیت هاب دا هەن.

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

ماڵپەڕی بنەڕەتی

ماڵپەڕی بنەڕەتی: https://api.tts.ai/v1/

هەموو خاڵەکانی کۆتایی پەیوەندیدارن بە ئەم ماڵپەڕە بنەڕەتییە. بۆ نمونە، خاڵی کۆتایی TTS بریتییە لە:

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

سنووری خێرایی

سنووری ڕێژەی API بە پلانەکە دەگۆڕێت:

پلان داواکاریەکان/خولەک هاوشێوە درێژترین درێژی نوسراو
ئازاد 10 2 ٥٠٠ هێما
دەستپێکەر 30 3 ١٠٠٠٠٠٠ لوتکە
پڕۆ 60 5 ١٠٠٠٠٠٠ لوتکە
کۆمپانیا 300 20 50,000 هێما

ناوەکانی سنووری ڕێژەیی لە هەموو وەڵامەکاندا بەکاردەهێنرێن: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

نرخی قەرز

خزمەتگوزاری نرخ یەکە
TTS (مۆدێلی ئازاد: Piper, VITS, MeloTTS) 1 کورسی بۆ هەر ١٠٠٠ پیت
TTS (مۆدێلی ستاندارد: کۆکۆرۆ، کۆسی ڤۆیس ٢، هتد.) بڕوانامە بۆ هەر ١٠٠٠ پیت
TTS (مۆدێلی پێشکەشکراو: Tortoise, Chatterbox, etc.) ٤ خاڵ بۆ هەر ١٠٠٠ پیت
قسەکردن بۆ نوسراو بڕوانامە بۆ هەر خولەکێکی دەنگ
دووبارە دروستکردنی دەنگی ٤ خاڵ بۆ هەر ١٠٠٠ پیت
گۆڕێنەری دەنگی 3 خاڵ بۆ هەر خولەکێکی دەنگ
پەرەپێدانی دەنگ بڕوانامە بۆ هەر خولەکێکی دەنگ
لابردنی دەنگی / دابەشکردنی دەنگی 3-4 خاڵ بۆ هەر خولەکێکی دەنگ
وەرگێڕانی قسەکردن ٥ خاڵ بۆ هەر خولەکێکی دەنگ
چاوپێکەوتنی دەنگ 3 خاڵ بۆ هەر چرکەیەک
دۆزینەوەی بژاردەکان ئازادە --
گۆڕێنەری دەنگ ئازادە --

نوسراو بۆ قسەکردن

POST /v1/tts/

ناونیشانەکە بگۆڕە بۆ دەنگی قسەکردن. فایلی دەنگی دەگەڕێنێتەوە بە شێوازی داواکراو.

بەشە داواکراوەکان

پێوانەجۆرپێویستهباسکردن
model string نەخێر ناسنامەی مۆدێل (بۆ نمونە kokoro, chatterbox, piper)
text string بەڵێ نوسراوە بۆ گۆڕینی بۆ قسەکردن (بەگشتی ٥,٠٠٠ پیت بۆ پرۆ، ٥٠,٠٠٠ پیت بۆ ئینتەرپرایز)
voice string بەڵێ ناسنامەی دەنگی (بەکاربهێنە /v1/voices/ بۆ تۆمارکردنی دەنگی بەردەستە)
format string نەخێر شێوازی دەرچوون: mp3 (پێوانە)، wav، flac، ogg
speed float نەخێر زیادکەری خێرایی قسەکردن. پێشنیار: 1.0. سنوور: 0.5 بۆ 2.0
language string نەخێر کۆدی زمان (بۆ نمونە en, es). بە خۆڕایی دەستنیشان دەکرێت ئەگەر واز لێبهێنرێت.
instructions string نەخێر کاردانەوە/ گەیاندنی نیشانەکان (≤٥٠٠ هێما). بۆ نمونە <کۆد>\
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-31سێی و یەک، نۆزدەیەم، نۆزدەیەم
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.

نمونەی تەواو

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/

دەنگ بگۆڕە بۆ نوسراو. پشتگیری ٩٩ زمان دەکات بە دۆزینەوەی خۆکارییەوە.

بەشە داواکراوەکان (multipart/form-data)

پێوانەجۆرپێویستهباسکردن
file file بەڵێ فایلی دەنگ (MP3, WAV, FLAC, OGG, M4A, MP4, WebM). زۆرترین ١٠٠ مێگابایت.
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 بەڵێ ئامۆژگاری دەنگی دەنگ (١٠-٣٠ چرکە). زۆرترین ٢٠ مێگابایت.
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). زۆرترین ٥٠ مێگابایت
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 بەڵێ فایلی سەرچاوەی دەنگ بە زمانی بنەڕەتی. زۆرترین ١٠٠ مێگابایت.
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 بەڵێ سەرچاوەی فایلی دەنگیی قسەکردن. زۆرترین ٥٠ مێگابایت.
voice string بەڵێ نیشانەی دەنگی ئامانج بۆ دەنگی دەرچوون
model string نەخێر مۆدێل: openvoice (بەپێویستی)، chatterbox
emotion string نەخێر هەستی ئامانج: neutral, happy, sad, ragdy, excited
speed float نەخێر ڕێکخستنی خێرایی. پێشنیار: 1.0. سنوور: 0.5 بۆ 2.0

وەڵامدانەوە

فایلی دەنگیی گۆڕاو دەگەڕێنێتەوە وەک زانیاری باینەری

ئامێرەکانی دەنگ

پڕۆسێسکردنی کۆتا خاڵەکانی دەنگ بۆ پەرەپێدان، لابردنی دەنگی، دابەشکردنی ستەم، و زیاتر.

POST /v1/audio/enhance/

بایەخی دەنگ زیاد بکە: بێدەنگی کەمبکەرەوە، ڕوونی زیاد بکە، ڕوونکردنەوەی زۆر.

file fileفایلی دەنگ بۆ زیادکردن
denoise booleanکارپێکردنی کەمکردنەوەی دەنگ (پێشبینی: ڕاست)
enhance_clarity booleanباشترکردنی ڕوونی قسەکردن (پێوانە: ڕاست)
super_resolution booleanبەرزکردنەوەی بایەخی دەنگ (پێوانە: هەڵە)
strength integer١-٣ (ئاسا، مامناوەند، بەهێز). پێشنیار: ٢
POST /v1/audio/separate/

جیاکردنەوەی دەنگی دەنگەکان لە دەنگی ئامرازەکان (دەرکردنی دەنگی دەنگەکان) یان دابەشکردنی دەنگی دەنگەکان.

file fileفایلی دەنگ بۆ جیاکردنەوە
model stringdemucs (پێشنیارکراو) یان spleeter
stems integerژماره‌ی بنەکان: ٢، ٤، ٥، یان ٦ (پێوانە: ٢)
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/ ئازادە

لێکۆڵینەوەی دەنگ بۆ دەستنیشانکردنی کیب، بی پی إم، و ئیمزاکردنی کات.

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ڕێژەی بیتی دەرچوون بە کیلۆبیت/ چرکە: ٦٤، ١٢٨، ١٩٢، ٢٥٦، ٣٢٠
sample_rate integerڕێژەی نمونە: ٢٢٠٥٠، ٤٤١٠٠، ٤٨٠٠٠
channels stringmono یان stereo

چاوپێکەوتنی دەنگ

POST /v1/voice-chat/

دەنگ یان نوسراو بنێرە و وەڵامی ئەی ئای وەرگرە بە زمانێکی تێکەڵکراو.

بەشە داواکراوەکان (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 بە پێچەوانەوە. هەڵبژێرە بۆ وەرگرتنی کۆدێکی کۆکردنەوەی وێب کاتێک هەموو کارەکان تەواو دەبن.

پارامەترەکان

پێوانەجۆرباسکردن
textsarrayArray of objects: {text, model, voice}. Max 50 items.
webhook_urlstringURLی هەڵبژێردراو بۆ ئەنجامی POST کاتێک کۆدەکە تەواو دەبێت

وەڵامدانەوە

وەڵامی JSON
{
  "batch_id": "abc123",
  "total": 3,
  "completed": 0,
  "status": "processing"
}

پێشکەوتنی دەنگدان لەگەڵ GET /v1/tts/batch/result/?batch_id=abc123

داڕشتنی دەنگی

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 پاڵاوتن بە پێی ناسنامەی مۆدێل (بۆ نمونە 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
}

ژێرنووس نوێ

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

دروستکردنی ژێرنووسە هاوتاکان بۆ هەر ئەرکێکی تەواوکراوی TTS. هەڵدەستێت بە ڕێکخستنی وێسپێر لەسەر دەنگەکە و SRT یان WebVTT دەگەڕێنێتەوە. ئەنجامەکە لە دیسکدا بەجێدەهێڵرێت کەواتە بانگکردنی دووەم بۆ هەمان uuid واتە خوێندنەوەی دیسک.

پارامەترەکانی پرسیار

پێوانەپێویستهباسکردن
uuidبەڵێUUIDی کارەکە لەلایەن /v1/tts/ یان /v1/voice-clone/ەوە گەڕایەوە.
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 کە دەیکەیت. سنووری تۆمارکردن بۆ هەر هەژمارێک ٢٠٠ تۆمارە.

بەشە داواکراوەکان (POST)

پێوانەجۆرباسکردن
wordstringوشەکە بۆ گۆڕین (بۆ نمونە GIF, Anthropic). سنووری وشەکە هاوتا بوو.
replacementstringچۆنییەتی نووسینی بۆ مۆدێلەکە (بۆ نمونە jiff, ann THROP ick).
languagestringکۆدی هەڵبژێردراوی ئایسۆ. خالی = بە هەموو زمانەکان دەدرێت
case_sensitivebooleanپێشبینی نەخێر. بەتەواوەتی هاوشێوەی ڕاست
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-..."

دەتوانیت هەروەها داواکارییەکەت بەبێ بەجێهێشتن بگۆڕیت - pronunciations لەسەر هەر /v1/tts/ بانگکردنێک دابنێیت وەک شتێک یان وەک ڕیز (بڕوانە پارامەترەکانی خاڵی کۆتایی TTS).

گێڕەرەوەی وتار نوێ

پەڕەی tag ەکەیەوە نیشان دەدات و پەڕگەیەکی کورت دەخوات. جۆرێکی جیاوازە لە گێڕەرەوەی بابەت لە سەرەوە (کە بە ئۆتۆماتیکی پەڕەیەکی فراوان دەخاتە ناوەوە و هەموو پەڕگەکە دەگێڕێتەوە).

HTML
<script src="https://tts.ai/widget.js"
    data-voice="af_bella"
    data-model="kokoro"
    data-style="full"
    data-theme="light"></script>

دەنگی تۆمارکراو (دوبارەبوونەوەی بەردەوام)

پەڕەی دەنگێکی ڕەچاوکراو بۆ جارێکی تر دابگرە، نیشانەی دەنگێکی بەردەوام بەدەست بهێنە، پاشان ئەو نیشانە لە داواکاریەکانی TTS دا بەجێ بهێڵە لە جیاتی ئەوەی دەنگەکە بۆ هەموو بانگکردنێک دابگرە. باشترین بۆ کۆکردنەوەی زۆر.

نرخ: پارێزراوە بەبێ پارە (بێ پارە بۆ ڕۆژانە، بێ سنووری شوێن). نرخی دابەزاندن: ٥٠٠ پیتی یەکجار بۆ هەر دەنگێک. نرخی زیادکراو بۆ بەکارهێنان: +٥٠ پیتی زیادکراوە بۆ هەر بەرهەمێکی TTS کە ئاماژە بە دەنگێکی تۆمارکراو دەکات، لە سەرەوە بەهای بەرهەمهێنانی ئاسایی. دەنگەکان بەجێبهێڵ کە ئێستا پێویستت پێیان نییە بۆ ئەوەی بە بێ کاریان بمێننەوە؛ هەرکاتێک کاریان پێبکەیتەوە. هەردووکیان بانگکردنی APIی بێ پارەن.

دەنگێک دابگرە

POST https://tts.ai/api/v1/user-voices/ پێویست بە ڕەزامەندیە

فۆرمی زۆربەش. بەشی: فایل (پێویستە، ٥-٣٠س دەنگ)، ناو (پێویستە)، زمان (هەوڵدان، پێشبینی en)، مۆدێل (هەوڵدان - خۆکارانە دەنگێکی خۆش٢ هەڵدەبژێرێت بۆ zh/ja/ko ئەگەر نەبێ دەنگێکی کراوە)، پەسەند_کراوە (پێویستە، هەر نرخێکی ڕاست).

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/ (بەو شێوەیەی کە: ماڵپەڕی VPS، نەک api.tts.ai) لەگەڵ بەکارهێنەر_دەنگی_هەستکردن. ئێمە دەنگەکەت دەخەینە ناو کۆمپیوتەرەوە و ڕێگاکە بۆ پاڵپشتی دووبارە دروستکردن.

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/

نمونەی کۆد

نوسراو بۆ قسەکردن

داواکاریەکانی پایتۆن 
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')}")

قسەکردن بۆ نوسراو

داواکاریەکانی پایتۆن 
# 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();

قسەکردن بۆ نوسراو

جاڤا سکریپت 
// 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);

نوسراو بۆ قسەکردن

cURL 
# 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

قسەکردن بۆ نوسراو

cURL 
# 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"

دووبارە دروستکردنی دەنگی

cURL 
# 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

پەرەپێدانی دەنگ

cURL 
# 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 کلیلی ئەپی پی نەماوە یان هەڵەیە.
402 insufficient_credits بڕێکی کەم هەیە. زیاتر بکڕە لە /pricing/.
403 forbidden مۆڵەتت نییە بۆ گەیشتن بە ئەم سەرچاوەیە (بۆ نمونە بۆ پرسیارکردن لە کارەکانی بەکارهێنەرێکی تر). گەیشتن بە API خۆی لە هەموو پڕۆژەکاندا هەیە.
404 not_found مۆدێل یان دەنگی دۆزرایەوە.
413 file_too_large فۆڕمەکە زیاترە لە قەبارەی دیاریکراو.
429 rate_limited زۆر داواکاری هەیە. سەرنووسەکانی سنووری خێرایی تاقی بکەەوە.
500 internal_error هەڵەی خزمەتگوزاری. پاشان هەوڵبدە
503 model_loading مۆدێلەکە هەڵدەگیرێت. دووبارە هەوڵبدە دوای چەند چرکەیەک.

وێب هۆکس

بۆ ئەرکەکانی درێژخایەن (بەشکردنی بنکە، کۆپیکردن و نوسینەوە)، دەتوانیت پارامەترێکی webhook_url بدەیت. کاتێک ئەرکەکە تەواو دەبێت، ئێمە ئەنجامەکە دەنێرین بۆ URLەکەت.

Webhook
{
  "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"
}
ئەنجامەکانی وێب هۆک بۆ دابەزاندن بۆ ماوەی ٢٤ کاتژمێر دوای تەواوبوون. دڵنیابە لە دابەزاندنیان بە خێرایی.

ئامادەیت بۆ دروستکردن؟

کلیلی ئەپی پی خۆت بەدەست بهێنە و دەست پێبکە بە تێکەڵکردنی TTS.ai لەگەڵ ئەپلیکەیشنەکانتدا.

تۆماربکە بینینی پلانەکان