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

Tajuk
Authorization: Bearer YOUR_API_KEY
Dapatkan kunci API Anda dari dashboard akun.

Penuturan Suara

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

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

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