Dokumentasi API
Integrasikan Speech to Speech AI ke aplikasi Anda dengan REST API yang sederhana.
Cepat mulai
Mulailah dengan API Speech to Speech AI dalam waktu kurang dari 5 menit.
URL Dasar
https://api.speechtospeechai.com/v1
1. Mulai tugas
Setiap alat adalah permintaan POST dengan kunci API Anda. Jawabannya berupa ID tugas, bukan audionya.
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. Polling hasilnya
Periksa tugas setiap beberapa detik hingga statusnya completed, lalu unduh 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"}
Otentikasi
Semua permintaan API memerlukan otentikasi melalui kunci API di Authorization header.
Authorization: Bearer YOUR_API_KEY
Penuturan Suara
/v1/voice-clone/
Ucapkan teks dengan suara dari rekaman referensi singkat.
Tubuh Permintaan (multipart/form-data)
| Parameter | Tipe | Diperlukan | Deskripsi |
|---|---|---|---|
reference_audio |
file | Ya | Rekaman suara yang akan dikloning (disarankan 10-30 detik, hingga 60) |
text |
string | Ya | Teks yang diucapkan dengan suara tersebut |
model |
string | Tidak | chatterbox, openvoice, tortoise, atau gpt-sovits |
language |
string | Tidak | Kode bahasa (bawaan: en) |
Tanggapan
ID tugas (uuid). Polling GET /v1/speech/results/?uuid= hingga status bernilai completed, lalu unduh result_url.
Teks ke Bahasa yang Berceramah
/v1/tts/
Ubah teks ke audio pidato.
Tubuh Permintaan (multipart/form-data)
| Parameter | Tipe | Diperlukan | Deskripsi |
|---|---|---|---|
text |
string | Ya | Teks yang akan diubah (maks. 5000 karakter) |
model |
string | Tidak | kokoro (bawaan), piper, vits, atau bark |
voice_id |
string | Tidak | ID suara dari GET /v1/speech/voices/?model= |
language |
string | Tidak | Kode bahasa (bawaan: en) |
speed |
float | Tidak | Pengali kecepatan (0.5-2.0, baku 1.0) |
format |
string | Tidak | wav (bawaan), mp3, ogg, atau flac. Tag SSML dihapus sebelum sintesis. |
Tanggapan
ID tugas (uuid). Polling GET /v1/speech/results/?uuid= hingga status bernilai completed, lalu unduh result_url.
Pidato ke Teks
/v1/transcribe/
Transkrip audio ke teks dengan penanda waktu.
Tubuh Permintaan (multipart/form-data)
| Parameter | Tipe | Diperlukan | Deskripsi |
|---|---|---|---|
file |
file | Ya | Berkas audio/video untuk ditruksi |
model |
string | Tidak | large-v3 (bawaan) atau turbo |
language |
string | Tidak | Kode bahasa, atau auto untuk mendeteksinya (bawaan) |
enable_word_timestamps |
bool | Tidak | Tambahkan waktu mulai dan selesai untuk setiap kata |
callback_url |
string | Tidak | URL yang menerima hasil melalui POST saat tugas selesai |
Tanggapan
ID tugas (uuid). Polling GET /v1/transcribe/results/?uuid= hingga status bernilai completed; jawabannya lalu berisi text, language, dan segments.
Model yang Tersedia
Model Teks ke Suara
| ID Model | Deskripsi | Paling Cocok Untuk |
|---|---|---|
kokoro |
TTS multibahasa cepat | Penggunaan umum, latensi rendah |
piper |
TTS multibahasa ringan (hanya suara berlisensi secara umum) | Terjemahan cepat dalam 11 bahasa |
vits |
LJSpeech plus 108 VCTK speaker Inggris | Aksen Inggris |
bark |
TTS Generatif, 130 preset dalam 13 bahasa | Bervariasi, pengiriman ekspresif (slow) |
openvoice |
Kloning suara dan konversi suara opsional | Alternatif untuk Chatterbox |
chatterbox |
Kloning suara zero-shot dalam 23 bahasa; model konversi suara default | Kloning dari contoh pendek |
Model Suara ke Teks
| ID Model | Deskripsi | Paling Cocok Untuk |
|---|---|---|
whisper-large-v3 |
OpenAI Whisper Large v3 | Akurasi tertinggi, multibahasa |
whisper-turbo |
Pembisik Teroptimasi untuk kecepatan | Transkripsi cepat |
Kode Galat
| Kode | Status | Deskripsi |
|---|---|---|
invalid_api_key |
401 | Kunci API tak valid atau hilang |
insufficient_credits |
402 | Tidak cukup kredit untuk operasi ini |
rate_limit_exceeded |
429 | Terlalu banyak permintaan |
invalid_request |
400 | Tubuh permintaan salah bentuk |
model_not_found |
404 | Model yang diminta tidak ada |
voice_not_found |
404 | Suara yang diminta tidak ada |
file_too_large |
413 | Berkas yang diunggah melebihi batas ukuran |
server_error |
500 | Galat server internal |