API मिसिलीकरण
हाम्रो REST API संग आफ्नो अनुप्रयोगहरूमा TTS.ai एकीकृत गर्नुहोस्। सजिलो माइग्रेसनको लागि OpenAI-संगत ढाँचा।
सारांश
TTS.ai एपीआईले सबै प्लेटफर्म सुविधाहरूमा प्रोग्रामेटिक पहुँच प्रदान गर्दछ: पाठ-देखि-भाषण संश्लेषण, भाषण-देखि-पाठ प्रतिलिपि, आवाज क्लोनिंग, अडियो सुधार, र अधिक। एपीआईले JSON अनुरोध / प्रतिक्रिया शरीरहरूको साथ मानक REST सम्मेलनहरू प्रयोग गर्दछ।
API कुञ्जी
यसबाट तपाईँको एपीआई कुञ्जी प्राप्त गर्नुहोस् खाता सेटिङ. प्रो र उद्यम योजनाहरूमा उपलब्ध।
आधार यूआरएल
https://api.tts.ai/v1/
प्रमाणीकरण गर्नुहोस्
बेयरर टोकन मार्फत Authorization हेडर
प्रमाणीकरण
/v1/tts/ कुनै पनि auth बिना काम, सम्म 5,000 प्रति आईपी वर्ण / दिन, हाम्रो मुक्त मोडेल को कुनै पनि प्रयोग (piper, vits, melotts, kokoro). एक नि: शुल्क खाता प्राप्त गर्न साइन अप 15,000 बोनस वर्ण र प्रिमियम मोडेल पहुँच.
प्रिमियम मोडेल र उच्च दर सीमाहरूको लागि, मा एक बोक्ने टोकन संग प्रमाणित Authorization हेडर.
Authorization: Bearer sk-tts-your-api-key-here
एसडीके
आधिकारिक एसडीकेहरूले 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 सँग सम्बन्धित छन् । उदाहरणका लागि, TTS अन्त्यबिन्दु:
दर सीमा
API दर सीमा योजना द्वारा भिन्न हुन्छ:
| योजना | अनुरोध/मिनेट | एकै समयमा | अधिकतम पाठ लम्बाइ |
|---|---|---|---|
| स्वतन्त्र | 10 | 2 | ५०० क्यारेक्टर |
| सुरुआतकर्ता | 30 | 3 | क्यारेक्टर |
| प्रो | 60 | 5 | क्यारेक्टर |
| उद्यम | 300 | 20 | ५०,००० क्यारेक्टर |
दर सीमा हेडर प्रत्येक प्रतिक्रियामा समावेश गरिएको छ: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
ऋण लागत
| सेवा | लागत | एकाइ |
|---|---|---|
| TTS (मुफ्त नमूनाहरू: पाइपर, VITS, MeloTTS) | १००० क्यारेक्टर | प्रति १००० क्यारेक्टर |
| TTS (मानक नमूना: Kokoro, CosyVoice2, आदि) | २,००० क्यारेक्टर | प्रति १००० क्यारेक्टर |
| TTS (प्रिमियम मोडेल: Tortoise, Chatterbox, आदि) | ४,००० क्यारेक्टर | प्रति १००० क्यारेक्टर |
| पाठमा भाषणName | २,००० क्यारेक्टर | प्रति मिनेट अडियो |
| आवाज क्लोनिङ | ४,००० क्यारेक्टर | प्रति १००० क्यारेक्टर |
| आवाज परिवर्तनकर्ताName | ३ क्रेडिट | प्रति मिनेट अडियो |
| अडियो सुधार | २,००० क्यारेक्टर | प्रति मिनेट अडियो |
| स्वर हटाउनुहोस् / आवाज विभाजन गर्नुहोस् | ३,०००-४,००० क्यारेक्टर | प्रति मिनेट अडियो |
| वक्तव्य अनुवाद | ५,००० क्यारेक्टर | प्रति मिनेट अडियो |
| आवाज कुराकानी | ३ क्रेडिट | प्रत्येक पालो |
| कुञ्जी र बीपीएम फेला पार्ने | स्वतन्त्र | -- |
| अडियो रूपान्तरणकर्ताName | स्वतन्त्र | -- |
पाठ वाचकComment
पाठलाई बोल्ने अडियोमा रूपान्तरण गर्नुहोस् । अनुरोध गरिएको ढाँचामा अडियो फाइल फर्काउँछ ।
अनुरोध मुख्य भाग
| परिमिति | प्रकार | आवश्यक | वर्णन: |
|---|---|---|---|
| model | string | होइन | नमूना आईडी (जस्तै, kokoro, chatterbox, piper) । यदि मेटिएको भएमा, हामीले अनुरोध गरिएको language समर्थन गर्ने नमूना स्वचालित रूपमा रोज्छौं — en/ja/zh/ko/fr/de/it/pt/es/hi/ru का लागि kokoro, अन्य समर्थित भाषाका लागि piper (ar/pl/nl/cs/da/fi/el/hu/tr/uk/vi/etc.) । |
| 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 | होइन | कार्य / वितरण संकेत (≤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
पाठमा अडियो प्रतिलिपि गर्नुहोस् । स्वचालित पत्ता लगाउनेसँग ९९ भाषाहरू समर्थन गर्दछ ।
अनुरोध मुख्य भाग (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 |
प्रतिक्रिया
{
"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 | हो | सन्दर्भ आवाज अडियो (१०-३० सेकेन्ड सिफारिस गरिएको) । अधिकतम २० मेगाबाइट । |
| text | string | हो | क्लोन गरिएको आवाजमा बोल्ने पाठ । |
| model | string | होइन | क्लोन नमूना: chatterbox (पूर्वनिर्धारित), cosyvoice2, gpt-sovits |
| format | string | होइन | निर्गत ढाँचा: mp3 (पूर्वनिर्धारित), wav, flac |
| language | string | होइन | लक्षित भाषा सङ्केत । चयन गरिएको नमूनाद्वारा समर्थित हुनुपर्छ । |
प्रतिक्रिया
TTS अन्त्यबिन्दु जस्तै, बाइनरी डेटाको रूपमा अडियो फाइल फर्काउँछ ।
आवाज परिवर्तनकर्ताName
अडियोलाई फरक आवाज जस्तै ध्वनिमा रूपान्तरण गर्नुहोस् । स्रोत अडियो अपलोड गर्नुहोस् र लक्षित आवाज रोज्नुहोस् ।
अनुरोध मुख्य भाग (multipart/form-data)
| परिमिति | प्रकार | आवश्यक | वर्णन: |
|---|---|---|---|
| file | file | हो | स्रोत अडियो फाइल (MP3, WAV, FLAC) । अधिकतम ५० मेगाबाइट । |
| 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 | हो | मौलिक भाषामा स्रोत अडियो फाइल । अधिकतम १०० मेगाबाइट । |
| target_language | string | हो | लक्षित भाषा कोड (जस्तै, es, fr, de, ja) |
| 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 | हो | स्रोत भाषण अडियो फाइल । अधिकतम ५० मेगाबाइट । |
| voice | string | हो | निर्गत भाषणका लागि लक्षित आवाज आईडी |
| model | string | होइन | नमूना: openvoice (पूर्वनिर्धारित), chatterbox |
| emotion | string | होइन | लक्षित भावना: neutral, happy, sad, angry, excited |
| speed | float | होइन | गति समायोजन । पूर्वनिर्धारित: 1.0 । दायरा: 0.5 देखि 2.0 सम्म |
प्रतिक्रिया
बाइनरी डेटाको रूपमा रूपान्तरित अडियो फाइल फर्काउँछ ।
अडियो उपकरणName
अडियो प्रोसेसिंग अन्त बिन्दुहरू बढावा, स्वर हटाउन, जरा विभाजन, र अधिक लागि।
अडियो गुणस्तर बढाउनुहोस्: denoise, स्पष्टता सुधार, सुपर रिजोल्युसन।
| file file | बढाउनका लागि अडियो फाइल |
| denoise boolean | ध्वनि हटाउने सक्षम पार्नुहोस् (पूर्वनिर्धारित: ठीक) |
| enhance_clarity boolean | भाषण स्पष्टता बढाउनुहोस् (पूर्वनिर्धारित: सही) |
| super_resolution boolean | अडियो गुणस्तर बढाउनुहोस् (पूर्वनिर्धारित: गलत) |
| strength integer | १-३ (लामो, मध्यम, सानो) । पूर्वनिर्धारित: २ |
यसले वायुमण्डलमा रहेका हानिकारक तत्वहरू (विषाक्त पदार्थहरू)लाई बाहिर निकाल्छ।
| file file | विभाजन गर्नका लागि अडियो फाइल |
| model string | demucs (पूर्वनिर्धारित) वा spleeter |
| stems integer | स्टेमहरूको सङ्ख्या: २, ४, ५, वा ६ (पूर्वनिर्धारित: २) |
| 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 | केबीपीएसमा निर्गत बिटरेट: ६४, १२८, १९२, २५६, ३२० |
| 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 सिर्जनाका लागि बहुविध पाठहरू पेश गर्नुहोस् । सबै काम पूरा हुँदा वैकल्पिक रूपमा वेबहुक कलब्याक प्राप्त गर्नुहोस् ।
परिमिति
| परिमिति | प्रकार: | वर्णन |
|---|---|---|
| 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 सर्भर स्थिति, लोड गरिएको नमूना, र लाम साइज जाँच गर्नुहोस् । प्रमाणीकरण आवश्यक छैन । ३० सेकेन्डका लागि क्यास गरिएको ।
प्रतिक्रिया
{
"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 | नमूना आईडीद्वारा फिल्टर गर्नुहोस् (जस्तै, 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
}
उपशीर्षक (SRT / VTT) नयाँ
कुनै पनि पूरा भएको TTS कामका लागि समक्रमण उपशीर्षकहरू उत्पन्न गर्नुहोस् । अडियोमा Whisper पङ्क्तिबद्धता चलाउँछ र 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 अनुरोधमा स्वत: लागू हुन्छ । प्रति खाता २०० प्रविष्टि सीमा ।
अनुरोध मुख्य भाग (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-..."
तपाईँले तिनीहरूलाई बचत नगरी प्रति-अनुरोध अधिलेखन पास गर्न सक्नुहुन्छ - कुनै पनि /v1/tts/ कलमा pronunciations वस्तु वा एरेको रूपमा समावेश गर्नुहोस् (TTS अन्त बिन्दु 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 नमूना आईडी । पूर्वनिर्धारित kokoro । |
data-extract | auto (पूर्वनिर्धारित) — लेख/मुख्य/.post-content/.entry-content चयनकर्ताहरू प्रयास गर्दछ, सबैभन्दा घनत्व अनुच्छेद क्लस्टरमा फर्किन्छ। वा कुनै पनि सीएसएस चयनकर्तालाई विशिष्ट तत्व लक्षित गर्न पास गर्नुहोस्। |
data-position | bottom (पूर्वनिर्धारित) वा top । |
data-color | हाइलाइट रङ (कुनै पनि CSS रङ) । पूर्वनिर्धारित #e60000 । |
data-min-chars / data-max-chars | यदि लेख कम्तिमा-कारहरू (पूर्वनिर्धारित २००) भन्दा छोटो भएमा बार फड्काउनुहोस् । अधिकतम-कारहरूमा आगत (पूर्वनिर्धारित ५०,०००) मा क्याप गर्नुहोस् । |
यसको प्रकाशन काठमाडौंमा साप्ताहिक अवधिमा हुन्छ।
बटन विजेट
इनलाइन बटन-शैली सम्मिलित । यसको ट्याग नजिकै रेन्डर गर्दछ र बटन-ट्रिगर गरिएको छोटो स्निपेट प्ले गर्दछ । माथिको लेख कथाकारबाट फरक आकार (जसले पृष्ठ-विस्तार पट्टी स्वत:-इन्जेक्ट गर्दछ र सम्पूर्ण लेखलाई वर्णन गर्दछ) ।
<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 स्वचालित-पिक्स), 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 मा बचत गरिएको आवाज प्रयोग गर्नुहोस्
/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/
सङ्केत उदाहरण
पाठ वाचकComment
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)
पाठ वाचकComment
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);
पाठ वाचकComment
# 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 |
पर्याप्त क्यारेक्टर छैन। / मूल्य / मा थप खरिद। |
| 403 | forbidden |
तपाईँसँग यो संसाधन पहुँच गर्न अनुमति छैन (उदाहरणका लागि अर्को प्रयोगकर्ताको काम पोलिंग) । API पहुँच आफैँमा हरेक योजनामा समावेश गरिएको छ । |
| 404 | not_found |
नमूना वा आवाज फेला परेन । |
| 413 | file_too_large |
अपलोड गरिएको फाइल साइज सीमा भन्दा बढी छ । |
| 429 | rate_limited |
धेरै अनुरोध । दर सीमा हेडर जाँच गर्नुहोस् । |
| 500 | internal_error |
सर्भर त्रुटि । पछि फेरि प्रयास गर्नुहोस् । |
| 503 | model_loading |
नमूना लोड हुँदैछ । केही सेकेन्डमा पुन: प्रयास गर्नुहोस् । |
वेबहुक
लामो चलिरहेको कार्यहरूका लागि (स्टेम विभाजन, ब्याच TTS), तपाईँले webhook_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"
}
निर्माण गर्न तयार?
आफ्नो एपीआई कुञ्जी प्राप्त र आफ्नो आवेदन मा TTS.ai एकीकृत सुरु.