एपीआई प्रलेखन

सत्यापन

प्रीमियम मॉडल तथा उच्च दर सीमा के लिए, एक बीयर टोकन के साथ सत्यापन Authorization शीर्षिका.

Authorization: Bearer sk-tts-your-api-key-here

के डीकेस

आधिकारिक SKSKINK आपके अनुप्रयोग में TTS.ai को एकीकृत करने के लिए आसान कर देता है. दोनों खुले स्रोत हैं और Hhb पर उपलब्ध हैं.

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

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

बेस यूआरएल

सभी अंतिम बिन्दु इस आधार यूआरएल के सापेक्ष हैं. उदाहरण के लिए, टीएसएसटीपाइंट है:

दर सीमा

प्लान किया गया है

दर सीमा शीर्षों को प्रत्येक जवाब में शामिल किया जाता है: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

क्रेडिट कास्ट्स

बोलने के लिए पाठ

पाठ को ऑडियो ऑडियो में बदलें. निवेदित फॉर्मेट में ऑडियो फ़ाइल वापस लें.

निवेदन शरीर

उदाहरण निवेदन

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

SSएमएल टैग

संख्या, तारीख़, करेंसी, फोन नंबर, तथा caconms <कोड>

तारीख प्रारूप <कोड> " को अंग्रेजी के लिए मूलभूत रूप से सेट करता है और <कोड>

[बन्द /] अन्य में <कोड>

{
  "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

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

Step 2: Poll for result

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

{
  "status": "completed",
  "result_url": "https://api.tts.ai/static/downloads/77b71db5.../output.mp3"
}

{
  "status": "processing"
}

Step 3: Download audio

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

पूरा उदाहरण

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.

पाठ से वार्ता

ऑडियो को पाठ में स्केल करें. समर्थन 99 भाषाओं को स्वतः जाँच के साथ समर्थन करता है.

निवेदन शरीर (multipart/form-data)

प्रतिक्रिया

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

प्रतिक्रिया

ऑडियो फ़ाइल को द्विचर डाटा के रूप में बताता है, जैसे कि टीटीएस के रूप में.

आवाज परिवर्तक

ध्वनि को भिन्न आवाज की तरह बदलें. अपलोड करने के लिए श्रोत और एक लक्ष्य आवाज चुनें.

निवेदन शरीर (multipart/form-data)

उदाहरण निवेदन

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)

प्रतिक्रिया

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

प्रतिक्रिया

परिवर्तित ऑडियो फ़ाइल को द्विचर डाटा के रूप में बताता है.

ऑडियो औज़ार

ध्वनि प्रक्रिया अंत में प्रक्षेपक, मुखक हटाने, विन्यासक विभाजन, और उससे भी अधिक करती है ।

{
  "key": "C",
  "scale": "Major",
  "bpm": 120.0,
  "time_signature": "4/4",
  "camelot": "8B",
  "compatible_keys": ["C Major", "G Major", "F Major", "A Minor"]
}

आवाज़-चीत

ऑडियो या पाठ भेजें और स्लोने वाले शब्दों के साथ एआई प्रतिक्रिया प्राप्त करें.

निवेदन शरीर (multipart/form-data या 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
}

बैच टीएस

समानांतर टीटीसी पीढ़ी के लिए बहुत से पाठ जमा करें. जब सभी कार्य पूरा हों तो वैकल्पिक रूप से वेब कॉलबैक प्राप्त करें.

पैरामीटर्स

प्रतिक्रिया

{
  "batch_id": "abc123",
  "total": 3,
  "completed": 0,
  "status": "processing"
}

मिल /v1/ ttk/ tttp/?

आवाज एम्बेडिंग

ऑडियो से गुप्त रूप से एक आवाज पैकिंग दर्ज करें. बाद में विडगेट के लिए कनेक्ट_BAR_रिकार्ड निवेदन पास की पीढ़ी के लिए करता है.

पैरामीटर्स

प्रतिक्रिया

{
  "embed_id": "emb_abc123",
  "model": "chatterbox",
  "duration_ms": 450
}

स्वास्थ्य जाँच

जीपीयू सर्वर स्थिति, लोड मॉडल तथा कतार आकार जाँचें. कोई प्रमाणीकरण आवश्यक नहीं. कैश 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
    }
  ]
}

स्थिति सूची

सभी उपलब्ध ध्वनि की सूची लौटाता है, मॉडल या भाषा द्वारा वैकल्पिक रूप से फिल्टर.

क्वैरी पैरामीटर

प्रतिक्रिया

{
  "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 या वेब प्लेयर को पलटता है तो परिणाम डिस्क में कैश किया जाता है ताकि एक ही विजुअल डिस्क में एक बार पढ़ने के लिए दूसरा कॉल है.

क्वैरी पैरामीटर

curl "https://api.tts.ai/v1/speech/subtitles/?uuid=$UUID&format=srt&download=1" -o subtitles.srt

उच्चारण शब्दकोश नया

TTS इंजिन को विशिष्ट शब्दों को कैसे घोषित करें. प्रविष्टियों को प्रत्येक टीईएस निवेदन के लिए स्वचालित सहेजें

निवेदन शरीर (POST)

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

आप उन्हें बचाने के बिना प्रति प्रति मिनट ओवरराइड कर सकते हैं - शामिल करें <कोड>

आलेख उत्पत्तिर नया

एक एकल <कोड> टैग किसी भी आलेख पृष्ठ पर टैग रखें और यात्रा करनेवाले एक स्थिर पाठक पट्टी पाते हैं जो कि पृष्ठ क्लिक पर वर्णन करता है. स्वतः आलेख के मुख्य भाग को निर्धारित करते हैं, पसंदीदा आवाज / भाषा में / भाषा रंग का रंग समर्थन करता है.

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

विकल्प

GiB पर स्रोत: < abon=\

बटन विज़ेट सुनें

इनलाइन बटन शैली. इसके अगले बटन को रेंडर करता है <कोड> टैग और एक बटन-ponting छोटा है. ऊपर से आलेख के अलग आकार (जो कि पेज-ning बार बंद करता है और सारे आलेख का वर्णन करता है.

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

सहेजा गया उपयोक्ता (प्रयोगक डाउनलोड)

एक संदर्भ ऑडियो अपलोड करें, एक बार एक आग्रहित आवाज वापस लाएँ, तब संदर्भ है कि टीएसएस निवेदन में हर कॉल के बजाए i- अप ऑडियो को फिर से लोड करने के लिए निवेदन करता है. मैं उच्च-वोल संयोजन के लिए आदर्श हूँ.

आवाज़ अपलोड करें

POST https://tts.ai/api/v1/user-voices/ एटीएम आवश्‍यक

मल्टीरे फ़ॉर्म. क्षेत्र: फ़ाइल (re-30, 5-30 ऑडियो), भाषा (वैकल्पिक, डिफ़ॉल्ट, मॉडल (वैकल्पिक), मॉडल (वैकल्पिक), स्वतः ejk/kosefak/Owakeue2 के लिए स्वचालित समर्थन, upphat_BAR_ Andine (किसी भी सत्य मूल्य आवश्यक है).

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"
}

टीटीटी में सहेजे गए आवाज का प्रयोग करें

उपयोक्ता के साथ /ap/v1/ tpe/ (कोई नहीं): वेब Wepephys, कोई pepaphs. ocs) नहीं है। हम आपका ऑडियो लोड कर रहे हैं और क्षमा करने के लिए मार्ग।

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

अभिलेख / फिर से सक्रिय करें (फ्री)

अभिलेखित आवाज आपके खाते में रहती है लेकिन TTSTS में उपयोग नहीं किया जा सकता. उपयोगी अंत उपयोक्ता के लिए उपयोगी है ताकि आपकी सूची साफ रहे.

POST https://tts.ai/api/v1/user-voices/uv_a1b2c3d4e5f6/archive/
POST https://tts.ai/api/v1/user-voices/uv_a1b2c3d4e5f6/reactivate/

कोड उदाहरण

• Python
• JavaScript
• cURL

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

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

न्यूक्लासhaiti. kgm

लंबे सफर किए कार्यों के लिए (स्किक विभाजन, बैच TS), आप एक <कोड_BAR_kturturt _center> पैरामीटर प्रदान कर सकते हैं. जब कार्य पूरा हो जाएगा, हम आपके 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"
}