Dokumentasi API
Integrikan Speech to Speech AI ke dalam aplikasi anda dengan API REST yang mudah.
Mula Cepat
Mulakan dengan API Speech to Speech AI dalam masa kurang dari 5 minit.
URL Asas
https://api.speechtospeechai.com/v1
1. Mulakan kerja
Setiap alat adalah POST dengan kekunci API anda. Jawapan adalah id kerja, bukan audio.
curl -X POST https://api.speechtospeechai.com/v1/tts/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "text=Hello! Welcome to Speech to Speech AI." \
-F "model=kokoro" \
-F "voice_id=af_heart" \
-F "format=mp3"
{"uuid": "3f2c...", "job_id": "...", "status": "queued"}
2. Soalan untuk hasil
Minta kerja setiap beberapa saat sehingga status selesai, kemudian muat turun result_url.
curl "https://api.speechtospeechai.com/v1/speech/results/?uuid=3f2c..." \
-H "Authorization: Bearer YOUR_API_KEY"
{"status": "completed", "result_url": "https://.../output.mp3"}
Pengesahan
Semua permintaan API memerlukan pengesahan melalui kekunci API dalam Authorization pengepala.
Authorization: Bearer YOUR_API_KEY
Klon Suara
/v1/voice-clone/
Tuturkan teks dalam suara rakaman rujukan pendek.
Badan Permintaan (data-berbilang-bahagian/bentuk)
| Parameter | Jenis | Diperlukan | Huraian |
|---|---|---|---|
reference_audio |
file | Ya | Rekod suara untuk klon (10-30 saat disyorkan, sehingga 60) |
text |
string | Ya | Teks untuk diucapkan dalam suara itu |
model |
string | Tidak | chatterbox, openvoice, tortoise atau gpt-sovits |
language |
string | Tidak | Kod bahasa (piawai: en) |
Balasan
Id kerja (uuid). Soalan GET /v1/speech/results/?uuid= sehingga status selesai dan muat turun result_url.
Teks ke Tutur
/v1/tts/
Tukar teks ke audio pertuturan.
Badan Permintaan (data-berbilang-bahagian/bentuk)
| Parameter | Jenis | Diperlukan | Huraian |
|---|---|---|---|
text |
string | Ya | Teks untuk ditukar (maksimum 5000 aksara) |
model |
string | Tidak | kokoro (piawai), piper, vits atau bark |
voice_id |
string | Tidak | id suara dari GET /v1/speech/voices/?model= |
language |
string | Tidak | Kod bahasa (piawai: en) |
speed |
float | Tidak | Pengganda kelajuan (0.5-2.0, default 1.0) |
format |
string | Tidak | wav (piawai), mp3, ogg atau flac. Tag SSML dibuang sebelum sintesis. |
Balasan
Id kerja (uuid). Soalan GET /v1/speech/results/?uuid= sehingga status selesai dan muat turun result_url.
Tutur ke Teks
/v1/transcribe/
Transkrip audio ke teks dengan setem masa.
Badan Permintaan (data-berbilang-bahagian/bentuk)
| Parameter | Jenis | Diperlukan | Huraian |
|---|---|---|---|
file |
file | Ya | Fail audio/video untuk ditranskripsikan |
model |
string | Tidak | besar-v3 (piawai) atau turbo |
language |
string | Tidak | Kod bahasa, atau auto untuk mengesannya (piawai) |
enable_word_timestamps |
bool | Tidak | Tambah masa mula dan akhir untuk setiap perkataan |
callback_url |
string | Tidak | URL yang menerima hasil oleh POST bila kerja selesai |
Balasan
id kerja (uuid). Soal GET /v1/transcribe/results/?uuid= sehingga status selesai; jawapan kemudiannya membawa teks, bahasa dan segmen.
Model yang ada
Model Teks-ke-Tutur
| ID Model | Huraian | Terbaik Untuk |
|---|---|---|
kokoro |
TTS multibahasa pantas | Penggunaan umum, latensi rendah |
piper |
TTS multibahasa ringan (hanya suara berlesen komersial) | Render pantas dalam 11 bahasa |
vits |
LJSpeech plus 108 VCTK penutur Bahasa Inggeris | Aksen Inggeris |
bark |
TTS Generatif, 130 praset dalam 13 bahasa | Bervariasi, penghantaran ekspresif (perlahan) |
openvoice |
Klon suara dan penukaran suara opsyenal | Pengganti untuk Chatterbox |
chatterbox |
Klon suara Zero-shot dalam 23 bahasa; model penukaran suara default | Klon dari sampel pendek |
Model Perbualan-ke-Teks
| ID Model | Huraian | Terbaik Untuk |
|---|---|---|
whisper-large-v3 |
OpenAI Whisper Large v3 | Ketepatan tertinggi, berbilang bahasa |
whisper-turbo |
Whisper dioptimasikan untuk kelajuan | Pentranskripsian pantas |
Kod Ralat
| Kod | Status | Huraian |
|---|---|---|
invalid_api_key |
401 | Kekunci API tidak sah atau hilang |
insufficient_credits |
402 | Tidak cukup kredit untuk operasi ini |
rate_limit_exceeded |
429 | Terlalu banyak permintaan |
invalid_request |
400 | Badan permintaan rosak |
model_not_found |
404 | Model yang diminta tidak wujud |
voice_not_found |
404 | Suara yang diminta tidak wujud |
file_too_large |
413 | Fail dimuat naik melebihi had saiz |
server_error |
500 | Ralat pelayan dalaman |