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

Pengepala
Authorization: Bearer YOUR_API_KEY
Dapatkan kunci API anda dari dashboard akaun.

Klon Suara

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

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

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