API دستاويز
اسان جي REST API سان TTS.ai کي پنهنجي ايپليڪيشنن ۾ شامل ڪريو. آسان منتقلي لاءِ OpenAI-compatible فارميٽ.
نظرثاني
TTS.ai API سڀني پليٽ فارم جي خاصيتن تائين پروگرامنگ رسائي فراهم ڪري ٿو: متن-to-speech synthesis، ڳالهائڻ-to-text transcription، آواز ڪلوننگ، آڊيو وڌائڻ، ۽ وڌيڪ. API JSON درخواست / جواب جي جسمن سان معياري REST معاهدن کي استعمال ڪري ٿو.
API ڪوڊ
پنھنجو API ڪوڊ ھتان حاصل ڪريو اڪائونٽ جون ترتيبون. پرو ۽ انٽرپرائز منصوبن تي دستياب.
بنياد URL
https://api.tts.ai/v1/
تصديق
بيئر ٽوڪين ذريعي Authorization هيڊر
تصديق
/v1/tts/ ڪنهن به auth کانسواءِ ڪم ڪريو، 5000 تائين ڪارڪن/ڏينهن تائين هر IP، اسان جي ڪنهن به مفت ماڊل کي استعمال ڪندي (piper, vits, melotts, kokoro). 15,000 بونس ڪارڪنن ۽ پريميئم ماڊلز تائين رسائي حاصل ڪرڻ لاءِ مفت اڪائونٽ لاءِ رجسٽر ڪريو.
سڀني API درخواستن کي توثيق جي ضرورت آھي Authorization هيڊر.
Authorization: Bearer sk-tts-your-api-key-here
ايس ڊي ڪي
سرڪاري SDKs 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 | حرف |
هر جواب ۾ شرح حد جي هيڊرن کي شامل ڪيو ويندو: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
قرض
| سروس | خرچ | يونٽ |
|---|---|---|
| TTS (آزاد ماڊل: Piper, VITS, MeloTTS) | 1 ڪرنٽ | هر 1,000 حروف |
| TTS (معياري ماڊل: Kokoro, CosyVoice 2, وغيره) | 2 کريڊٽ | هر 1,000 حروف |
| TTS (پريميئم ماڊل: Tortoise, Chatterbox, وغيره) | 4 کريڊٽ | هر 1,000 حروف |
| ڳالھائڻ کان متن | 2 کريڊٽ | هر منٽ آڊيو |
| آواز جو کلون | 4 کريڊٽ | هر 1,000 حروف |
| آواز تبديل ڪندڙ | 3 کريڊٽ | هر منٽ آڊيو |
| آڊيو بهتري | 2 کريڊٽ | هر منٽ آڊيو |
| وڪيول حذف / وڪيول ورهاڻ | 3-4 اکر | هر منٽ آڊيو |
| ڳالهائڻ جو ترجمو | 5 ڪرنٽ | هر منٽ آڊيو |
| آواز جي ڳالھائي | 3 کريڊٽ | هر دور ۾ |
| & BPM ڳوليندڙ | مفت | -- |
| آڊيو تبديل ڪندڙ | مفت | -- |
لکت مان ڳالھائڻName
متن کي ڳالھائڻ واري آڊيو ۾ تبديل ڪريو. درخواست ڪيل فارميٽ ۾ آڊيو فائل موٽائي ٿو.
درخواست جو جسم
| پيراميڊ | قسم | لازمي | بيان |
|---|---|---|---|
| model | string | نه | ماڊل ID (مثال، kokoro, chatterbox, piper) |
| text | string | ھائو | ڳالهائڻ ۾ تبديل ڪرڻ لاءِ متن (پرو لاءِ وڌ ۾ وڌ 5,000 حرف، انٽرپرائز لاءِ 50,000) |
| voice | string | ھائو | آواز جي سڃاڻپ (/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 -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.
ڳالھائڻ کان متن
آڊيو کي متن ۾ تبديل ڪريو. 99 ٻولين کي خودڪار ڳولا سان سپورٽ ڪري ٿو.
درخواست جو جسم (multipart/form-data)
| پيراميڊ | قسم | لازمي | بيان |
|---|---|---|---|
| file | file | ھائو | آڊيو فائل (MP3, WAV, FLAC, OGG, M4A, MP4, WebM). وڌ ۾ وڌ 100MB. |
| 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 سيڪنڊ صلاح ڏنل). وڌ ۾ وڌ 20MB. |
| text | string | ھائو | ڪلون ٿيل آواز ۾ ڳالهائڻ لاءِ متن. |
| model | string | نه | ڪلون ماڊل: chatterbox (درآمد)، cosyvoice2، gpt-sovits |
| format | string | نه | ٻاھر ڪڍڻ جي شڪل: mp3 (درآمد)، wav, flac |
| language | string | نه | مقصد جي ٻوليءَ جو ڪوڊ. چونڊيل ماڊل کي مدد ڏيڻي پوندي. |
جواب
آڊيو فائل کي بائنري ڊيٽا طور موٽائي ٿو، جيئن TTS آخري نقطو.
آواز تبديل ڪندڙ
آڊيو کي مختلف آواز وانگر ٻڌڻ لاءِ تبديل ڪريو. سرچشمو آڊيو اپ لوڊ ڪريو ۽ مقصد آواز چونڊيو.
درخواست جو جسم (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 -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 | ھائو | آڊيو فائل اصل ٻوليءَ ۾. وڌ ۾ وڌ 100MB. |
| target_language | string | ھائو | مقصد جي ٻوليءَ جو ڪوڊ (مثال، es, fr, de, ja) |
| 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 | ھائو | وڪيپيڊيا: |
| voice | string | ھائو | آڌار واري ڳالھائڻ لاءِ مقصد آواز جي ايڊريس |
| 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 | آڊيو جي معيار کي وڌي (دليل: غلط) |
| 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) |
ڪيچ، بي پي ايم، ۽ وقت جي دستخط کي ڳولڻ لاءِ آڊيو جو جائزو وٺو.
| 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 | 64, 128, 192, 256, 320 ۾ بيٽ رائيٽ |
| sample_rate integer | نموني جي شرح: |
| channels string | mono يا stereo |
آواز جي ڳالھائي
آڊيو يا متن موڪليو ۽ سنٿسيٽ ٿيل ڳالهائڻ سان 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 | نه | اڳيان واري ڳالهه ٻولهه جاري رکو |
جواب
{
"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 پيدا ڪرڻ لاءِ ڪيترائي متن داخل ڪريو. جڏهن سڀ ڪم پورا ٿين تڏھن اختياري طور 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 | ٻوليءَ جي ڪوڊ سان فلٽر ڪريو (مثال، en) |
| 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 ڪم لاءِ سنئين وقت تي عنوان پيدا ڪريو. آڊيو تي ويسپير سلائڊنگ هلائي ٿو ۽ SRT يا WebVTT موٽائي ٿو. نتيجو ڊسڪ تي ڪيش ڪيو ويندو آهي تنھنڪري ھڪ ئي uuid لاءِ ٻيو ڪال ڊسڪ پڙهڻ وانگر ٿيندو.
پڇا ڳاڇا
| پيراميڊ | لازمي | بيان |
|---|---|---|
| uuid | ھائو | /v1/tts/ يا /v1/voice-clone/ پاران واپس ڪيل ڪم UUID. |
| 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
ويڪرائي لکڻيءَ جي لغت نئون
TTS انجن کي ٻڌاءِ ته ڪھڙي طرح مخصوص لفظن کي پڙھي. محفوظ ڪيل داخلا توھان جي هر TTS درخواست تي پاڻمرادو لاڳو ٿيندا. 200-انٽرس جي حد هر اڪائونٽ تي.
درخواست جو جسم (POST)
| پيراميڊ | قسم | بيان |
|---|---|---|
| word | string | لفظ جيڪو مٿان لکجي (مثال: GIF, Anthropic). لفظ جي حد مطابقت رکي ٿي. |
| replacement | string | ماڊل لاءِ ان کي ڪيئن لکجي (مثال طور jiff, ann THROP 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-..."
توھان پڻ درخواست جي مٿان انھن کي محفوظ ڪرڻ کانسواءِ پاس ڪري سگھو ٿا - pronunciations شامل ڪريو ڪنھن به /v1/tts/ ڪالي تي يا ته هڪ شي يا هڪ آرري طور (TTS جي آخر واري نقطي جي پارامڪس ڏسو).
مضمون ٻڌائيندڙ نئون
ڪنهن به مضمون صفحي تي هڪ ٽيگ کي هٽايو ۽ ڏسندڙن کي هڪ ثابت پڙهندڙ بار مليو جيڪو ڪلڪ تي صفحي کي ٻڌائي ٿو. مضمون جي جسم کي خودڪار طور ڳولي ٿو، پسنديده آواز / ماڊل / جڳهه / ڌيان رنگ کي مدد ڏي ٿو.
<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 (درآمد) — آرٽيڪل/مئن/.post-content/.entry-content چونڊيندڙن جي ڪوشش ڪري ٿو، گھٽ ۾ گھٽ پراگراف ڪلسٽر ڏانهن موٽندو آهي. يا ڪنهن به CSS چونڊيندڙ کي ڪنهن خاص عنصر کي نشانو بڻائڻ لاءِ موڪليندو آهي. |
data-position | bottom (درآمد) يا top. |
data-color | ڌيان وارو رنگ (ڪجھه CSS رنگ). #e60000. |
data-min-chars / data-max-chars | جيڪڏھن مضمون min-chars کان ننڍو آھي (درآمد 200) ته بار کي ڇڏ. max-chars تي داخلا کي بند ڪريو (درآمد 50,000). |
ٻڌڻ بٽڻ وجھڻ
داخل ٿيل بٽڻ-شڪل وارو داخل ڪرڻ. ٽيگ جي ويجهو رنڊڪ ڏئي ٿو ۽ بٽڻ-تڪرار وارو مختصر ٽڪرو وڄائي ٿو. مٿين آرٽيڪل ٻڌائيندڙ کان مختلف شڪل (جو پاڻمرادو صفحي جي بار کي داخل ڪري ٿو ۽ پورو آرٽيڪل ٻڌائي ٿو).
<script src="https://tts.ai/widget.js"
data-voice="af_bella"
data-model="kokoro"
data-style="full"
data-theme="light"></script>
محفوظ ٿيل آواز (مستقيم کلون)
ھڪ ڀيرو ھڪ حوالو آڊيو اپ لوڊ ڪريو، ھڪ ھميشہ موجود آواز_آئي ڊي واپس وٺو، پوءِ TTS درخواستن ۾ اھو آءِ ڊي رجوع ڪريو جڏھن ته آڊيو کي هر ڪال جي بدران ٻيهر اپ لوڊ ڪيو وڃي. وڏي حجم وارين گڏجاڻين لاءِ مثالي.
آواز اپ لوڊ ڪريو
POST
https://tts.ai/api/v1/user-voices/
تصديق جي ضرورت آھي
ڪيترن حصن واري فارم. علائقا: فائل (لازمي، 5-30s آڊيو)، نالو (لازمي)، ٻولي (اختياري، ڊفالٽ en)، ماڊل (اختياري — zh/ja/ko لاءِ خودڪار طور cosyvoice2 چونڊيندو، ٻي صورت ۾ 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 to /api/v1/tts/ (نھ: ويب 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')}")
ڳالھائڻ کان متن
# 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();
ڳالھائڻ کان متن
// 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
ڳالھائڻ کان متن
# 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 |
ماڊل لوڊ ڪيو وڃي ٿو. ڪجھ سيڪنڊن ۾ ٻيهر ڪوشش ڪريو. |
ويبھوڪ
ڊگهي عرصي تائين هلندڙ ڪمن (Stem splitting, 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 کي پنھنجي ايپليڪيشنن ۾ شامل ڪرڻ شروع ڪريو.