API Documentation
Kubatanidza Speech to Speech AI mukushandisa yako ne nyore REST API.
Kutanga kwacho
Kutanga ne Speech to Speech AI API mu 5 maminitsi.
Chikamu che URL
https://api.speechtospeechai.com/v1
1. Kutanga basa
Kana iwe ukawana kuti mashoko akafanana, edza kuisa mashoko akafanana mubhokisi rezvinyorwa.
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. Poll yezvakaitika
Kubvunza kuti basa zuva nezuva mazuva mashoma kusvika status yakamisikidzwa, uye wobva warodha 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"}
Ku_zivana
All API zvinoda kubvumidzwa kuburikidza API key mu Authorization header.
Authorization: Bearer YOUR_API_KEY
Kutaura
/v1/voice-clone/
Chii chinonzi kutamba? Chii chinonzi kutamba? Chii chinonzi kutamba?
Kukumbira Body (multipart / form-data)
| Parameter | Type | Anodarika | Kutaura |
|---|---|---|---|
reference_audio |
file | Yes | Kurekodha kwezwi kuti clone (10-30 masekondi inokurudzira, kusvika 60) |
text |
string | Yes | Tevere, nyora kuti utore mashoko |
model |
string | Hapana | chatterbox, openvoice, tortoise kana gpt-sovits |
language |
string | Hapana | Kodzero dzechirungu (default: en) |
Kutenda
Itai nhamba yebasa (uuid). Sarudza data kubva pa URL iyi: GET /v1/speech/results/?uuid= kusvikira iyo nhanho "yakapedzwa" ichiratidzwa, uye wobva dhowunlodha data iri pa "result_url".
Tevere
/v1/tts/
Kushandura tebhu kuti mashoko audio.
Kukumbira Body (multipart / form-data)
| Parameter | Type | Anodarika | Kutaura |
|---|---|---|---|
text |
string | Yes | Text to convert (max 5000 characters) |
model |
string | Hapana | kokoro (yakajairika), piper, vits kana bark |
voice_id |
string | Hapana | Bvaidzwa rehuwandu hwezwi kubva ku GET /v1/speech/voices/?model= |
language |
string | Hapana | Kodzero dzechirungu (default: en) |
speed |
float | Hapana | Kudhumisira kwemaitiro (0.5-2.0, zvinoreva kuti 1.0 nekudaro). |
format |
string | Hapana | wav (yakajairika), mp3, ogg kana flac. SSML tags zvinorwadzwa pamberi pekuumbwa. |
Kutenda
Itai nhamba yebasa (uuid). Sarudza data kubva pa URL iyi: GET /v1/speech/results/?uuid= kusvikira iyo nhanho "yakapedzwa" ichiratidzwa, uye wobva dhowunlodha data iri pa "result_url".
Kutaura-Ku-Tekisi
/v1/transcribe/
Chengeta mazwi akabvazwa kuita mameseji, uchishandisawo nguva yacho mazwi acho akabvazwa.
Kukumbira Body (multipart / form-data)
| Parameter | Type | Anodarika | Kutaura |
|---|---|---|---|
file |
file | Yes | Faira/vhidhiyo inoda kudzidza zvaanoreva. |
model |
string | Hapana | large-v3 (yakajairika) kana turbo |
language |
string | Hapana | Chinyorwa chechitauro, kana kuti otomatiki kuongorora (yakajairika) |
enable_word_timestamps |
bool | Hapana | Kuwedzera nguva yekutanga nenguva yekupera kune ese mazwi |
callback_url |
string | Hapana | URL iyo inowana mhinduro nePOST kana basa richipera |
Kutenda
Itai nhamba yebasa (uuid). Sarudza ruzivo kubva pa URL iri: GET /v1/transcribe/results/?uuid= kusvikira iyo "status" ichiratidza kuti basa rapera; apo, uchawana mameseji, chiremba, uye maparicha.
Mamodeli Anowanikwa
Maitiro ekushandisa mashoko kuti aonekwe sezvinhu.
| Model ID | Kutaura | Yakanaka Kwauri |
|---|---|---|
kokoro |
Tekinoroji yekutaura yemitauro yakawanda, inogona kushandiswa nekukurumira. | General usage, low latency |
piper |
Lightweight multilingual TTS (kuzvitoro licensed mashoko chete) | Fast renders mu11 languages |
vits |
LJSpeech plus 108 VCTK English vanotaura | Chirungu |
bark |
Generative TTS, 130 presets mu13 languages | Kusiyana, kuratidzwa kwechiratidzo (slow) |
openvoice |
Voice cloning uye sarudzo yezwi kushandura | Chimwe chinhu cheChatterbox |
chatterbox |
Zero-shot voice cloning mu23 languages; default voice conversion model | Cloning kubva ku sample yakafupi |
Kutaura-ku-Tekisi Models
| Model ID | Kutaura | Yakanaka Kwauri |
|---|---|---|
whisper-large-v3 |
OpenAI Whisper Large v3 | Yakakwira kunyatsoita, multilingual |
whisper-turbo |
Optimized Whisper yekumhanya | Fast transcription |
Maitiro eKukanganisa
| Chinyorwa | Status | Kutaura |
|---|---|---|
invalid_api_key |
401 | API key yakaipa kana yakaipa |
insufficient_credits |
402 | Hapana zvikwereti zvakakwana zveiyi chiitiko |
rate_limit_exceeded |
429 | Kukumbira kwakawanda kwazvo |
invalid_request |
400 | Yakaipa-yakagadzirwa chikumbiro chemuviri |
model_not_found |
404 | Chikumbiro chekupinda hachikwanisi kuitwa |
voice_not_found |
404 | Chikumbiro chezwi hachigone kuitwa |
file_too_large |
413 | Kukwira kwefaira kunosvika pakuenzanisa |
server_error |
500 | Server error |