Dokumentasi API

Otentikasi

Untuk model premium dan batas tingkat yang lebih tinggi, otentikasi dengan token Bearer dalam Authorization tajuk.

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

SDK

Official SDKs make it easy to integrate TTS.ai into your application. Both are open source and available on GitHub.

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

URL Dasar

Semua titik akhir relatif terhadap URL dasar ini. Sebagai contoh, titik akhir TTS adalah:

Batas Laju

Batas tingkat API bervariasi menurut rencana:

Tingkat batas header termasuk dalam setiap respon: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Biaya Kredit

Teks ke Pidato

Ubah teks ke audio pidato. Mengembalikan berkas audio dalam format yang diminta.

Badan Permintaan

Permintaan Contoh

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

Tag SSML

Wrap nomor, tanggal, mata uang, nomor telepon, dan akronim dalam

Format tanggal baku ke mdy untuk bahasa Inggris dan dmy di tempat lain; override dengan 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."
}

Tanggapan

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.

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)

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

Pidato ke Teks

Transkrip audio ke teks. Mendukung 99 bahasa dengan auto-deteksi.

Badan Permintaan (multipart/form-data)

Tanggapan

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

Kloning Suara

Hasilkan pidato dalam suara kloning. Unggah sebuah referensi audio dan teks.

Badan Permintaan (multipart/form-data)

Tanggapan

Mengembalikan berkas audio sebagai data biner, sama seperti titik akhir TTS.

Voice Changer

Ubah audio ke suara lain. Unggah audio sumber dan pilih suara target.

Badan Permintaan (multipart/form-data)

Permintaan Contoh

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

Tanggapan

Mengembalikan berkas audio yang dikonversi sebagai data biner.

Terjemahan Tutur Kata

Terjemahkan audio yang digunakan dari satu bahasa ke bahasa lain. Combined speech-to-text, terjemahan, dan teks-to-peech dalam satu panggilan.

Badan Permintaan (multipart/form-data)

Tanggapan

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

Tutur Kata

Ubah gaya bicara, emosi, atau pengiriman sewaktu menyimpan isi. Berguna untuk menyesuaikan nada, kecepatan, dan ekspresif.

Badan Permintaan (multipart/form-data)

Tanggapan

Mengembalikan berkas audio yang diubah sebagai data biner.

Perkakas Audio

Titik akhir pemrosesan audio untuk peningkatan, penghapusan vokal, pemisahan batang, dan masih banyak lagi.

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

Percakapan Suara

Kirim audio atau teks dan terima jawaban AI dengan pidato yang disintesis.

Badan Permintaan (multipart/form-data atau JSON)

Tanggapan

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

Kirim beberapa teks untuk pembuatan TTS paralel. Pilihannya menerima panggilan webhook ketika semua pekerjaan selesai.

Parameter

Tanggapan

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

Kemajuan polon dengan GET /v1/tts/batch/result/?batch_id=abc123

Embedding Suara

Pra-compate sebuah embedding suara dari audio referensi. Gunakan embed_id yang dikembalikan dalam permintaan kloning suara selanjutnya untuk generasi dekat-instant.

Parameter

Tanggapan

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

Pemeriksaan Kesehatan

Periksa status server GPU, model yang dimuat, dan ukuran antrian. Tak diperlukan otentikasi. Cached selama 30 detik.

Tanggapan

{
  "status": "online",
  "latency_ms": 45,
  "queue_size": 3,
  "models_loaded": ["kokoro", "chatterbox", "cosyvoice2"]
}

Daftar Model

Mengembalikan daftar semua model yang tersedia dengan kemampuan mereka.

Tanggapan

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

Daftar Suara

Mengembalikan daftar semua suara yang tersedia, dengan pilihan tersaring berdasarkan model atau bahasa.

Parameter Kuiri

Tanggapan

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

Teks (SRT / VTT) baru

Hasilkan subtitel yang disinkronkan untuk pekerjaan TTS yang telah selesai. Jalankan Whisper alignment atas audio dan mengembalikan SRT atau WebVTT. Hasil dicache di disk sehingga panggilan kedua untuk uuid yang sama adalah sebuah baca disk.

Parameter Kuiri

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

Kamus Pengucapan baru

Beritahu mesin TTS bagaimana mengucapkan kata-kata spesifik. Masukan disimpan otomatis ke setiap TTS meminta Anda membuat. Batas per-akun 200-entry.

Badan Permintaan (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-..."

Anda juga dapat melewati overrides per-request tanpa menyimpannya termasuk janji pada setiap /v1/tts/panggilan sebagai baik sebuah objek atau sebuah array (lihat params titik akhir TTS).

Artikel Narator baru

Jatuhkan satu tag pada halaman artikel apapun dan pengunjung mendapatkan sebuah bar pembaca tetap yang menceritakan halaman pada klik. Auto-detects tubuh artikel, mendukung suara kustom / model / aksen warna.

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

Opsi

Sumber pada GitHub:

• 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

Kode Galat

Semua kesalahan mengembalikan respon JSON dengan error lapangan.

{
  "error": {
    "code": "insufficient_credits",
    "message": "You do not have enough characters for this request.",
    "characters_required": 4000,
    "characters_available": 2000
  }
}

Webhook

Untuk tugas yang berjalan panjang (stem split, batch TTS), Anda dapat menyediakan webhook_url parameter. Ketika tugas selesai, kami akan POST hasil ke URL Anda.

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