Àkọsílẹ̀ API

Ṣàfikún TTS.ai nínú àwọn ìṣàmúlò-ètò rẹ̀ láti inú REST API wa. Ìṣàmúlò-ètò OpenAI-ọ̀fẹ̀ fun ìjánu-ìjánú rọ́ọ̀nù.

REST API Àwọn Ìṣàmúlò-ètò Àwọn ìṣàfihàn JSON Àwọn Ìṣàmúlò-ètò

Àwọn ìṣàmúlò-ètò

TTS.ai API náà náà gba ìwọlé ìṣàmúlò-ètò fún àwọn àbùdá àwọn ààyè-iṣẹ́ gbogbó: àkọlé-si-ìbàlẹ̀, àkọlé-si-ìbàlẹ̀, ìṣàfarawe-ìbàlẹ̀, ìṣàfihàn àwọn àwòrán, àti àwọn mìíràn. API náà náà ló àwọn ìṣàmúlò-ètò REST ìṣàfarawe-ètò láti mú àwọn ẹ̀yàn ìṣàfihàn/ìjánú ìṣàfihàn JSON.

Bọ́tìnì API

Gba àwọn bọ́tìnì API rẹ̀ láti Àwọn Ààtòjú Àwọn. Wa ni Pro ati Enterprise plans.

URL Ìdálẹ̀

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

Àwọn Àmì-ìwé

Àwọn Ìṣàmúlò-ètò Authorization àwọn àmì-ìwé

Àwọn Ìṣàmúlò-ètò

Àwọn ìpele àìfẹ́fẹ́ — kò ní bọ́tìnì kan tí a fẹ́. Àwọn àkọlé àìdálẹ̀ /v1/tts/ iṣẹ́ laisi àwọn ẹ̀yàn, lọ́wọ́lọ́wọ́ si 5,000 àwọn àmì-àṣírí/ọ̀jọ̀ kan nípa IP kan, nípa lòjútó àwọn módè́lì ọ̀fẹ́ wa (piper, vits, melotts, kokoro). Ṣabẹwo fun kaadi iroyin ọfẹ lati gba awọn aami 15,000 ti o dara julọ ati wọle si awọn awoṣe premium.

Fun àwọn ìṣàmúlò-ètò àti àwọn ìpéjúwé ìṣàmúlò-ètò tí o gà jú, ṣàfihàn láti ló tókè Béèrì nínú Authorization àwọn àmì-ìwé.

Àwọn Àmì-ìwé HTTP
Authorization: Bearer sk-tts-your-api-key-here
Fi àwọn bọ́tìnì API rẹ pamọ́. Kò pẹ̀lú àwọn ìṣàmúlò-ètò ààyè-iṣẹ́, àwọn ìpamọ́ àwọn alábòójútó alábòójútó, tàbí àwọn ìṣàmúlò-ètò. Àwọn bọ́tìnì ìṣàfihàn láti inú àtòjọ-ẹ̀yàn rẹ̀.

Àwọn SDK

SDKs Oṣójọ́lẹ̀ ṣé ìmọ̀ràn láti fi TTS.ai pamọ́ sínú ìṣàmúlò-ètò rẹ̀. Wọ́n ní afẹ́fẹ́ àwọn ìṣàmúlò-ètò náà, àti àwọn náà ní a lè gba nípa 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")
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

URL Ìdálẹ̀

URL Ìdálẹ̀: https://api.tts.ai/v1/

Àwọn ààyè-iṣẹ́ ìparí gbogbó ní pàtó nípa URL̀ ìtọ́nà yìí. Fun ààyè-iṣẹ́ ìparí TTS ni:

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

Àwọn Ìdálẹ̀ Ìjánu-ìṣàmúlò-ètò

Àwọn ìdájọ́ àwọn ìṣàmúlò-ètò API nípa àwọn ìṣàmúlò-ètò:

Àwọn ààyè-iṣẹ́ Àwọn Ìtàn/minútùù Àwọn ìṣàfarawé Ìgbà pípẹ́ àkọlé pípẹ́ jú
Àìfẹ́ 10 2 Àwọn àmì-ìwé 500
Àwọn Ìṣàmúlò-ètò 30 3 Àwọn àmì-ìwé 1,000,000
Àwọn 60 5 Àwọn àmì-ìwé 1,000,000
Àwọn Ìṣàfilọ́lẹ̀ 300 20 Àwọn àmì-ìwé 50,000

Àwọn àmì-ìwé-ìwé ìdáràn nínú àwọn ìsàlẹ̀-ilà gbogbo: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Àwọn Ìṣàmúlò-ètò

Àwọn Àṣẹ Àwọn Irinṣẹ́ Àwọn Ìgúnrégé
TTS (Móòdù Fẹ́ẹ̀: Piper, VITS, MeloTTS) Àwọn àyọkà 1,000 fún àwọn àmì-àṣírí 1,000
TTS (Móòdù ìpèwọ̀n: Kokoro, CosyVoice 2, abbl.) Àwọn àyọkà 2,000 fún àwọn àmì-àṣírí 1,000
TTS (Móòdù Premium: Tortoise, Chatterbox, abbl.) Àwọn ìṣàmúlò-ètò fún àwọn àmì-àṣírí 1,000
Àwọn Àmì-ìwé Àwọn àyọkà 2,000 Àwọn àwọn àwòrán
Àwọn Àmì-ìwé Àwọn ìṣàmúlò-ètò fún àwọn àmì-àṣírí 1,000
Àtòjọ-ẹ̀yàn Àwọn Àmì-ìwé Àwọn àyọkà 3,000 Àwọn àwọn àwòrán
Àwọn ìṣàfarawé àwòrán Àwọn àyọkà 2,000 Àwọn àwọn àwòrán
Ìjádè àwọn àmì-ìwé / Ìjádé àwọn àmì-ìwé Àwọn àyọkà 3,000-4,000 Àwọn àwọn àwòrán
Àwọn ìṣàfarawé kọ̀ǹpútà Àwọn àyọkà 5,000 Àwọn àwọn àwòrán
Àkọlé àwòrán Àwọn àyọkà 3,000 Àwọn ìṣàfarawé àwọn ààyè-iṣẹ́
Alábòójútó Bọ́tìnì BPM Àìfẹ́ --
Àwọn Ìjánu-ìṣàmúlò-ètò Àìfẹ́ --

Àkọlé sí Àkọ́kọ́

POST /v1/tts/

Ṣàfikún àyọkà náà sí àwòrán àkọlé. Ṣàfikún fáìlì àwòrán nínú ìrísí-lẹ́tà tí a beere.

Àwọn ìṣàmúlò-ètò

Àwọn ìkúndùǹÀwọn Ìṣàmúlò-ètòTí a fẹ́Àkóónú
model string Àwọn àwọn àgbéwọlé ID Móòdù (gẹ́gẹ́ bí kokoro, chatterbox, piper). Tí a bá fi pà, a á yan móòdù tí ó bá jẹ́ ìrànwọ́ àwọn àkànṣe tí a bì - kokoro fún en/ja/zh/ko/fr/de/it/pt/es/hi/ru, piper fún àwọn àkànṣe mìíràn tí a bá jẹ́ ìrànwọ́ (ar/pl/nl/cs/da/fi/el/hu/tr/uk/vi/etc.).
text string Yà Àkọlé tí a fẹ́ láti yipada sí ìṣàfarawé (àwọn àmì-ìwé 100,000 lórí ìtàn)
voice string Yà Àtòjọ Àwọn Àwòrán (lo /v1/voices/ láti ṣàfihàn àwọn àwòrán tí a ní)
format string Àwọn àwọn àgbéwọlé Àwọn ìṣàmúlò-ètò àwọn ààtò: mp3 (ò̀tọ́), wav, flac, ogg
speed float Àwọn àwọn àgbéwọlé Àwọn ìṣàfarawé ìpele ìṣàfihàn. Àwọn ìpéwọ̀n: 1.0. Àwọn ìpele: 0.5 sí 2.0
language string Àwọn àwọn àgbéwọlé Àtòjọ-ètò ìtàn (gẹ́gẹ́ bíi, en, es). Àtòjọ-ètò ìṣàfilọ́lẹ̀ láti inú ìṣàfilọ́lẹ̀.
instructions string Àwọn àwọn àgbéwọlé Àwọn àwọn àgbékalẹ̀/àfilọ́lẹ̀ (àtí àwọn àmì-ìwé ≤500). e.g. \
pronunciations object | array Àwọn àwọn àgbéwọlé Àwọn ìṣàfarawé àwọn ìṣàfihàn-nípa-ìgbègbè. Àwọn {\
stream boolean Àwọn àwọn àgbéwọlé Fún àwọn àgbéwọlé ìjánu-ìjánu

Àwọn ìṣàmúlò-ètò

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

Àwọn àmì-ìwé SSML

Fi àwọn à

Àwọn àkọléÀwọn Ìjánu-ìwéTí a Fi Wí
cardinal1234one thousand two hundred thirty-four
ordinal21twenty-first
date1999-12-31December
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

Àwọn ìgúnrégé ìṣàmúlò-ètò àwọn àyọkà ìpéwọ̀n _Ṣẹ̀dà fun English ati dmy nígbà mìíràn; pàtó látì Ìgúnrégé=\

Àwọn Ààyè-iṣẹ́
{
  "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."
}

Àwọn ìsàlẹ̀-ilà

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.

Àwọn ààyè-iṣẹ́ ìṣàmúlò-ètò

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.

Àwọn Àmì-ìwé

POST /v1/stt/

Ṣàfihàn àwòrán láti inú àkọsílẹ̀. Ṣàfihàn àwọn ètò 99 láti inú ìṣàfilọ́lẹ̀ àtòjọ-ètò.

Àwọn ìṣàmúlò-ètò (multipart/form-data)

Àwọn ìkúndùǹÀwọn Ìṣàmúlò-ètòTí a fẹ́Àkóónú
file file Yà Fáìlì àwòrán (MP3, WAV, FLAC, OGG, M4A, MP4, WebM). Max 100MB.
model string Àwọn àwọn àgbéwọlé Àwọn àwọn àwòrán STT: whisper (pípálẹ̀), faster-whisper, sensevoice
language string Àwọn àwọn àgbéwọlé Àtòjọ-ẹ̀yàn. àtòjọ-ẹ̀yàn fún ìṣàfihàn-àtòjọ-ẹ̀yàn (píríǹtì).
timestamps boolean Àwọn àwọn àgbéwọlé Ṣàfikún àwọn àkóónú àkóónú. Àtòjọ-ẹ̀yàn: fáìlì
diarize boolean Àwọn àwọn àgbéwọlé Mú ìṣàfilọ́lẹ̀ àwọn àkọlé àwòrán ṣiṣẹ́. Àtòjọ-ẹ̀yàn: fáìlì

Àwọn ìsàlẹ̀-ilà

Àwọn ìṣàfihàn 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"
    }
  ]
}

Àwọn Àmì-ìwé

POST /v1/tts/clone/

Ṣẹ̀dà àkọlé nínú àwòrán. Lọ́ọ̀kan àwòrán àti àyọkà ìṣàfilọ́lẹ̀.

Àwọn ìṣàmúlò-ètò (multipart/form-data)

Àwọn ìkúndùǹÀwọn Ìṣàmúlò-ètòTí a fẹ́Àkóónú
reference_audio file Yà Àwọn àwòrán àwòrán ìṣàfihàn (10-30 àwọn ìsàlẹ̀-ilà). Max 20MB.
text string Yà Àkọlé láti sọ nínú ìrànwọ́ ìṣàfarawé.
model string Àwọn àwọn àgbéwọlé Àwọn àwọn àwòrán: chatterbox (píríǹtì), cosyvoice2, gpt-sovits
format string Àwọn àwọn àgbéwọlé Àwọn ìṣàmúlò-ètò àwọn ààtò: mp3 (pípálẹ̀), wav, flac
language string Àwọn àwọn àgbéwọlé Àtòjọ-ètò ìsàlẹ̀-ilà. Ò ní ìyànfàn láti inú àwọn móòdù tí a yàn.

Àwọn ìsàlẹ̀-ilà

Fi fáìlì ìsàlẹ̀-ilà àwọn ìṣàmúlò-ètò àwọn ìṣàmúlò-ètò àwọn ìṣàmúlò-ètò TTS padà.

Àtòjọ-ẹ̀yàn Àwọn Àmì-ìwé

POST /v1/voice-convert/

Ṣàfikún àwòrán láti jẹ́ àwòrán ìṣàmúlò-ètò mìíràn. Ṣàfikún àwòrán ìṣàmúlò-ètò náà láti yan àwòrán ìṣàmúlò-ètò.

Àwọn ìṣàmúlò-ètò (multipart/form-data)

Àwọn ìkúndùǹÀwọn Ìṣàmúlò-ètòTí a fẹ́Àkóónú
file file Yà Fáìlì ìrísí-lẹ́tà (MP3, WAV, FLAC). Max 50MB.
target_voice string Yà Àtòjọ-ẹ̀yàn àwòrán tí a fẹ́ láti yipada sí (lo /v1/voices/ láti ṣàfihàn àwòrán tí a nì)
model string Àwọn àwọn àgbéwọlé Móòdù ìyipadà àwòrán: openvoice (píríǹtì), knn-vc
format string Àwọn àwọn àgbéwọlé Àwọn ìṣàmúlò-ètò àtòjọ-ẹ̀yàn: wav (píríǹtì), mp3, flac

Àwọn ìṣàmúlò-ètò

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

Àwọn ìsàlẹ̀-ilà

Fi fáìlì àwòrán tí a yipadà padà sí bí àwọn ààtòjọ-ẹ̀yàn àìṣàfilọ́lẹ̀.

Àwọn ìṣàfarawé kọ̀ǹpútà

POST /v1/speech-translate/

Ṣàfihàn àwòrán tí a sọ láti inú ede kan sí mìíràn. Ṣàfihàn àwọn àkọlé-si-àkọlé, àwọn ìtumọ̀, àwọn àkọlé-si-àkọlé nínú awájú kan.

Àwọn ìṣàmúlò-ètò (multipart/form-data)

Àwọn ìkúndùǹÀwọn Ìṣàmúlò-ètòTí a fẹ́Àkóónú
file file Yà Fáìlì ìṣàmúlò-ètò ìsàlẹ̀-ètò nínú ìrísí-lẹ́tà ìṣàfarawé. Max 100MB.
target_language string Yà Àtòjọ-ètò ìsàlẹ̀-ilà (gẹ́gẹ́ bíi es, fr, de, ja)
voice string Àwọn àwọn àgbéwọlé Àwọn àwọn àyọkà ìṣàfihàn tí a tì tumọ̀. A yan nípa ìṣàfihàn látì jẹ́ pé a tì yọ̀.
preserve_voice boolean Àwọn àwọn àgbéwọlé Àwọn ààyè-iṣẹ́ àwọn ìṣàfarawé àwọn àkọlé

Àwọn ìsàlẹ̀-ilà

Àwọn ìṣàfihàn 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
}

Àwọn Àkọlé

POST /v1/speech-to-speech/

Ṣàfikún àwọn ìṣàmúlò-ètò ìṣàfihàn, àwọn ìrànwọ́, tàbí ìgbàdálẹ̀ nígbà tí o bá tọju àwọn ìṣàfihàn. Lòòròlò fún ìṣàfihàn àwọn ìṣàfihàn, àwọn ìṣàfihàn, àwọn ìṣàfihàn.

Àwọn ìṣàmúlò-ètò (multipart/form-data)

Àwọn ìkúndùǹÀwọn Ìṣàmúlò-ètòTí a fẹ́Àkóónú
file file Yà Fáìlì àwòrán ìṣàfihàn. Max 50MB.
voice string Yà Àwọn àwọn àmì-ìwé àwọn àmì-ìwé àwọn àwọn àmì-ìwé
model string Àwọn àwọn àgbéwọlé Àwọn ìṣàmúlò-ètò: openvoice (píríǹtì), chatterbox
emotion string Àwọn àwọn àgbéwọlé Àkọ́lé àwòrán: ọ̀fẹ́, ọ̀fẹ́, ọ̀pọ̀lú, ọ̀pọ̀lú, ọ̀pọ̀lú
speed float Àwọn àwọn àgbéwọlé Àwọn ìṣàmúlò-ètò ìṣàfarawé ìrànwọ́. Àwọn ìpéwọ̀n: 1.0. Àwọn ìjánu-ìsún: 0.5 sí 2.0

Àwọn ìsàlẹ̀-ilà

Fi fáìlì àwòrán tí a tì yipadà padà sí bí àwọn ààtòjọ-ìdákọ àwọn ìṣàfarawé.

Àwọn Àtòjọ-ẹ̀yàn Àkọsílẹ̀

Àwọn ààyè-iṣẹ́ ìparí ìṣàfarawé àwòrán fún ìṣàfarawé, ìjánu-ìṣàmúlò-ètò, ìjánu-ìṣàfilọ́lẹ̀, àti àwọn mìíràn mìíràn.

POST /v1/audio/enhance/

Ṣàfihàn àwọn ìṣàmúlò-ètò àwòrán: denoise, ìṣàfihàn ìwọ̀n, àwọn ìṣàfihàn nla.

file fileFáìlì àwòrán tí a fẹ́ mú
denoise booleanṢàfikún àwọn ìṣàmúlò-ètò tí a kò fẹ́ (òrò: òótọ́)
enhance_clarity booleanṢẹ̀dà ìròyìn àkọlé ( ìpéwọ̀n: òótọ́)
super_resolution booleanÌdáràn àwọn ìṣàmúlò-ètò ìṣàfarawé àwọn ìṣàmúlò-ètò
strength integer1-3 (ìwọ̀n, ìsàlẹ̀-ilà, ìpéwọ̀n). Àtòjọ-ẹ̀yàn: 2
POST /v1/audio/separate/

Ṣàfarawe àwọn àwòrán láti inú àwọn àkọlé (àwọ̀n àwòrán) tàbí fi àwọn àwọn àgbèwọlé pamọ́.

file fileFáìlì àwòrán láti ṣí
model stringdemucs (Àwọn ìpéwọ̀n) tabi spleeter
stems integerÀwọn àwọn ìṣàmúlò-ètò: 2, 4, 5, tàbí 6 (òòrò: 2)
format stringÀwọn ìṣàmúlò-ètò ìjánu-ìṣàfilọ́lẹ̀: wav, mp3, flac
POST /v1/audio/dereverb/

Ṣàfikún àgbègbè àti àgbègbè láti inú àwọn àkọsílẹ̀ àwòrán.

file fileFáìlì àwòrán láti ṣe ìṣàfarawé
type stringecho or reverb (default: both)
intensity integer1-5 (default: 3)
POST /v1/audio/analyze/ Àìfihàn

Ṣàfihàn àwòrán láti ṣàfihàn bọ́tìnì, BPM, àti àwọn ìṣàmúlò-ètò àwọn ìṣàfihàn àkókò.

file fileFáìlì ìsàlẹ̀-ilà láti ṣàfihàn
Àwọn ìsàlẹ̀-ilà
{
  "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/ Àìfihàn

Ṣàfikún àwòrán laarin àwọn ìrísí-lẹ́tà.

file fileFáìlì àwòrán láti yipada
format stringÀwọn ìgúnrégé àwọn àkọ́lé: mp3, wav, flac, ogg, m4a, aac
bitrate integerBítàrátì ìjánu-ìjánu nínú kbps: 64, 128, 192, 256, 320
sample_rate integerÀwọn ìṣàmúlò-ètò:
channels stringmono tabi stereo

Àkọlé àwòrán

POST /v1/voice-chat/

Fi àwòrán tàbí àkọlé pamọ́ ki o si gba ìjánu-íjánu AI nípa ìṣàfarawe-ìrọ̀.

Àwọn ìṣàmúlò-ètò (multipart/form-data tabi JSON)

Àwọn ìkúndùǹÀwọn Ìṣàmúlò-ètòTí a fẹ́Àkóónú
audio file Àwọn àwọn àgbéwọlé* Ààyè-iṣẹ́ àwòrán (yàni àwòrán tàbí àyọkà tí a fẹ́)
text string Àwọn àwọn àgbéwọlé* Àwọn ìṣàmúlò-ètò àyọkà (ọ̀kan ninu àwòrán tàbí àwòrán tí a fẹ́)
voice string Àwọn àwọn àgbéwọlé Àwòrán fún àgbékalẹ̀ AI. Àtòjọ-ẹ̀yàn: af_bella
tts_model string Àwọn àwọn àgbéwọlé Àwọn ìṣàmúlò-ètò TTS fún àgbékalẹ̀. Àtòjọ-ẹ̀yàn: kokoro
system_prompt string Àwọn àwọn àgbéwọlé Àwọn àgbèwọlé ìṣàmúlò-ètò fún AI
conversation_id string Àwọn àwọn àgbéwọlé Lọ́wọ́lọ́wọ́ àkọlé tí wa

Àwọn ìsàlẹ̀-ilà

Àwọn ìṣàfihàn 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
}

Àwọn àwọn

POST /v1/tts/batch/

Fi àwọn àkọlé àwọn ìṣàmúlò-ètò láti fi pamọ́ fún ìṣàfihàn TTS. Lọ́wọ́lọ́wọ́ gba àgbègbè wẹ́ẹ̀bùhookù láti inú àwọn iṣẹ́ láti pari.

Àwọn Àtòjọ-ẹ̀yàn

Àwọn Àtòjọ-ẹ̀yànÀwọn Ìṣàmúlò-ètòÀwọn Àkọlé
textsarrayArray of objects: {text, model, voice}. Max 50 items.
webhook_urlstringURL tí a fẹ́ láti fi àwọn àkóónú POST ṣẹ́ nígbà tí a bá fi àwọn àwọn ìṣàmúlò-ètò ṣẹ́.

Àwọn ìsàlẹ̀-ilà

Àwọn ìṣàfihàn JSON
{
  "batch_id": "abc123",
  "total": 3,
  "completed": 0,
  "status": "processing"
}

Àwọn ìṣàmúlò-ètò ìṣàfihàn àti GET /v1/tts/batch/result/?batch_id=abc123

Ìṣàfilọ́lẹ̀ Àwọn Àmì-ìwé

POST /v1/voice-embed/

Ṣàfikún ìṣàfilọ́lẹ̀ ìgbọ́ọ̀kan láti inú ìṣàfilọ́lẹ̀ ìgbọ́ọ̀kan. Lò àwọn àwọn ìṣàfilọ́lẹ̀_id tí a fi pamọ́ nínú àwọn ìtàn ìṣàfilọ́lẹ̀ ìgbọ́ọ̀kan láti mú ìṣàfilọ́lẹ̀ ìṣàfilọ́lẹ̀ láti inú ìṣàfilọ́lẹ̀.

Àwọn Àtòjọ-ẹ̀yàn

Àwọn Àtòjọ-ẹ̀yànÀwọn Ìṣàmúlò-ètòÀwọn Àkọlé
filefileReference audio file (WAV, MP3, FLAC).
modelstringCloning model (default: chatterbox). Supported: chatterbox, cosyvoice2, openvoice, gpt-sovits, spark, indextts2, qwen3-tts.

Àwọn ìsàlẹ̀-ilà

Àwọn ìṣàfihàn JSON
{
  "embed_id": "emb_abc123",
  "model": "chatterbox",
  "duration_ms": 450
}

Àwọn Àwọn Ààyè-iṣẹ́

GET /v1/health/

Ṣayẹwo ìṣàmúlò-ètò àwọn ààtò GPU, àwọn àwọn ìṣàmúlò-ètò àti ìwọ̀n ìṣàmúlò-ètò. Kò ní ìṣàfihàn ìṣàfihàn. A fi àwọn ìṣàfihàn pamọ́ fún àwọn ìṣísẹ̀ 30.

Àwọn ìsàlẹ̀-ilà

Àwọn ìṣàfihàn JSON
{
  "status": "online",
  "latency_ms": 45,
  "queue_size": 3,
  "models_loaded": ["kokoro", "chatterbox", "cosyvoice2"]
}

Àtòjọ àwọn ìṣàmúlò-ètò

GET /v1/models/

Ṣàfihàn àtòjọ àwọn ìṣàmúlò-ètò tó lè wa nínú àwọn ìṣàmúlò-ètò wọn.

Àwọn ìsàlẹ̀-ilà

Àwọn ìṣàfihàn 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
    }
  ]
}

Àwọn Àmì-ìwé Àtòjọ

GET /v1/voices/

Ṣàfihàn àtòjọ àwọn àwòrán tó lè wa ní pàtó, àti àwọn ìṣàmúlò-ètò ìṣàfihàn láti inú àwòrán tàbí àwòrán.

Àwọn Àlàyé Àwọn Àwọn Ààtò

Àwọn ìkúndùǹÀwọn Ìṣàmúlò-ètòÀkóónú
model string Píríǹtì láti inú ID ìṣàmúlò-ètò (gẹ́gẹ́ bíi kokoro)
language string Fi àwọn àmì-ìwé ìsàlẹ̀-ilà pamọ́ (gẹ́gẹ́ bíi en)
gender string Aṣàfilọ́lẹ̀ láti inú ìwọ̀n: ọmọkunrin, ọmọbinrin, ọ̀kan-ọ̀kan

Àwọn ìsàlẹ̀-ilà

Àwọn ìṣàfihàn 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
}

Àwọn àkọlé (SRT / VTT) new

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

Ṣẹ̀dà àwọn àkọlé àìdá fún àwọn iṣẹ́ TTS tó kù nínú. Rọ́ọ̀nù ìṣàfarawé àwọn àwọn ààyè-iṣẹ́ nínú àwòrán àti ìpàsẹ́ SRT tàbí WebVTT. Àwọn ààyè-iṣẹ́ náà ní pàtó nínú dísikì láti jẹ́ pé ayẹ̀wò kẹtà fún uuid tí a fẹ́ nínú dísikì náà.

Àwọn Àlàyé Àwọn Àwọn Ààtò

Àwọn ìkúndùǹTí a fẹ́Àkóónú
uuidYàUUID iṣẹ́ tí /v1/tts/ tàbí /v1/voice-clone/ fi pamọ́.
formatÀwọn àwọn àgbéwọlésrt (píríǹtì) tàbí vtt.
downloadÀwọn àwọn àgbéwọlé1 lati fi Ìṣàfihàn-Ìdákọ́ọ̀kan: àtòjọ-ẹ̀yàn ranṣẹ ki awáròyìn náà fipamọ́ láti inú àwọn ìṣàfihàn.
languageÀwọn àwọn àgbéwọléÀwọn ìṣàmúlò-ètò fún àwọn móòdù ìṣàfarawé (tí a bá gbọ́ nípa ìṣàfihàn).
cURL
curl "https://api.tts.ai/v1/speech/subtitles/?uuid=$UUID&format=srt&download=1" -o subtitles.srt

Àwọn Àwọn Àkọlé new

GET POST DELETE /api/v1/pronunciations/

Fi àwọn àwọn àgbéwọlé tí a fi pamọ́ pamọ́ sínú àwọn àgbéwọlé TTS. Àwọn àgbéwọlé tí a fi pamọ́ láti lo nípa àwọn ìṣàfilọ́lẹ̀ TTS gbogbò tí o ṣe. Ìgbà ìṣàfilọ́lẹ̀ 200 fun àwọn àgbéwọlé kan.

Àwọn ìṣàmúlò-ètò (POST)

Àwọn ìkúndùǹÀwọn Ìṣàmúlò-ètòÀkóónú
wordstringÀwọn àwọn àmì-ìwé àti àwọn àmì-ìwé àwọn àmì-ìwé GIF, Anthropic). Àwọn ìdàlẹ̀-ilà àwọn àmì-ìwé tí wọ́n bá.
replacementstringBii o ṣe le sọ ọ̀rọ̀ rẹ̀ fun àwọn móòdù (gẹ́gẹ́ bi jiff, ann THROP ick).
languagestringÀwọn ìkúndùǹ ISO tí a fẹ́. Tí kò bá jẹ́ = lò fún gbogbo àwọn ìtàn.
case_sensitivebooleanÀwọn ìpèwọ̀n Àṣìṣe. Fẹ̀ẹ̀ àwọn òótọ́Àwọn àwọn ààyè-iṣẹ́
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-..."

O lè fi àwọn ìṣàmúlò-ètò àwọn ìṣàmúlò-ètò-ìṣàfihàn pamọ́ láti àwọn ìṣàmúlò-ètò àti àwọn ìṣàmúlò-ètò Àwọn ìṣàfarawégbè nípa àwọn /v1/tts/ ayẹyẹ̀ bí ohun-ìtàn tàbí árí (wó àwọn àwọn ìṣàmúlò-ètò TTS).

Àwọn Àkọlé new

Drop a single <script> tag on any article page and visitors get a fixed reader bar that narrates the page on click. Auto-detects the article body, supports custom voice / model / position / accent color.

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

Àwọn Àtòjọ-ẹ̀yàn

Àwọn ìkúndùǹÀkóónú
data-pkBọ́tìnì àìfihàn (pk-tts-…). Àwọn ìdájọ́ dómìǹì tí a fi pamọ́ láti inú ààyè-iṣẹ́ àwọn_dómìǹì_tí a_fàyè gba bọ́tìnì náà.
data-voiceÀwọn àmì-ìwé àwòrán. af_bella ìpèwọ̀n.
data-modelID ìṣàmúlò-ètò TTS àwọn àgbèwọléÀwọn àwọn ààyè-iṣẹ́
data-extractÀtòjọ-ẹ̀yàn (ò̀tọ́) — ń gbiyanju àwọn àwọn ààtò àkọlé/òkè/.àwọn àkọlé-àfilọ́lẹ̀/.àwọn àwọn ààtò àwọn àwọn ààtò àwọn ààtò-àtò, gba padà sí àwọn ààtò àwọn àpèrẹ́kì tí o ní ìjánu-ìjánú. Àwọn lè fi àwọn ààtò CSS wọn pamọ́ láti lo àwọn ààtò kan.
data-positionbottom (píríǹtì) tàbí top.
data-colorÀwọ́ àwọn àyọkà ìṣàfarawé (ọ̀kan àwòrán CSS). Àwọn ìpéwọ̀n #e60.
data-min-chars / data-max-charsLọ́nà àkànṣe náà tí àkọlé bá jú àwọn àmì-àṣírí ìsàlẹ̀-ilà tó kéré jú (òkù ìpéwọ̀n 200). Fẹ́ àwọn àmì-àṣírí láti inú àwọn àmì-àṣírí ìparí (òkù ìpéwọ̀n 50,000).

Àkọlé àwòrán

Àwọn Àwọn Àtòjọ-ẹ̀yàn

Àwọn àgbèwọlé ìṣàmúlò-ètò bọ́tìnì inú àkànṣe. Àwọn ìṣàmúlò-ètò láti sàlù àwọn ààyè-iṣẹ́ rẹ