Bilow deg deg ah
Bilaw la Speech to Speech AI API hoos 5 daqiiqo.
URL-ka asalka ah
https://api.speechtospeechai.com/v1
1. Bilow shaqo
Qalabka kasta waa POST la API key. Jawaabtu waa shaqo id, ma aha 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. Poll ee natiijada
Su'aalo u shaqo kasta oo dhowr ilbiriqsi ilaa xaaladda la dhammeeyo, ka dibna soo dejisan 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"}
Adeegga aqoonsiga
dhammaan codsiyada API u baahan yihiin xaqiijinta ka dib markii API muhiimka ah ee Authorization madaxa.
Authorization: Bearer YOUR_API_KEY
Duubista Codka
/v1/voice-clone/
Hadal qoraalka in codka ka mid ah diiwaanka soo jeedinta gaaban.
weydiiso jirka (multipart/form-data)
| Parameter | Nooc | Waa in la raaco | Tilmaamaha |
|---|---|---|---|
reference_audio |
file | Haa | Recording of codka in la isku daro (10-30 ilbiriqsi oo lagu taliyey, ilaa 60) |
text |
string | Haa | qoraalka in la ku hadlo codkaas |
model |
string | Ha | chatterbox, openvoice, tortoise ama gpt-sovits |
language |
string | Ha | Koodka Afka (Default: en) |
Jawaab
A shaqo id (uuid). Doorashada GET /v1/speech/results/?uuid = ilaa xaaladda la dhammeeyo iyo soo dejisan result_url.
Qoraalka-u-hadalka
/v1/tts/
Text u beddelo hadalka audio.
weydiiso jirka (multipart/form-data)
| Parameter | Nooc | Waa in la raaco | Tilmaamaha |
|---|---|---|---|
text |
string | Haa | qoraalka in la beddelo (max 5000 xarfaha) |
model |
string | Ha | kokoro (default), piper, vits ama bark |
voice_id |
string | Ha | Magaca codka ka soo GET /v1/speech/voices/?model= |
language |
string | Ha | Koodka Afka (Default: en) |
speed |
float | Ha | Xawaaraha multiplier (0.5-2.0, default 1.0) |
format |
string | Ha | wav (default), mp3, ogg ama flac. SSML tags waa la tirtiri doonaa ka hor synthesization. |
Jawaab
A shaqo id (uuid). Doorashada GET /v1/speech/results/?uuid = ilaa xaaladda la dhammeeyo iyo soo dejisan result_url.
Hadal ilaa qoraal
/v1/transcribe/
Audio ku qor qoraalka la timestamps.
weydiiso jirka (multipart/form-data)
| Parameter | Nooc | Waa in la raaco | Tilmaamaha |
|---|---|---|---|
file |
file | Haa | Faylka audio/video ee la soo gudbin doono |
model |
string | Ha | large-v3 (default) ama turbo |
language |
string | Ha | Koodka Afka, ama si otomaatig ah u ogaado (default) |
enable_word_timestamps |
bool | Ha | Ku dar waqti bilow iyo dhamaad ah erey kasta |
callback_url |
string | Ha | URL oo ka helaan natiijada by POST marka shaqada dhamaystirtay |
Jawaab
A shaqo id (uuid). Doorashada GET /v1/transcribe/results/?uuid = ilaa xaaladda la dhammeeyo; jawaabta markaas waxaa la socda qoraalka, afka iyo qaybaha.
Midab la heli karo
Qoraalka-u-hadalka
| ID-ka qaabka | Tilmaamaha | Ugu Fiican |
|---|---|---|
kokoro |
TTS-ka dhaqsaha badan ee luqadaha badan | isticmaalka guud, laantii hoose |
piper |
TTS-ka yaryar ee luqadaha badan (codka ganacsi ee sharciyeysan oo keliya) | Fast renders in 11 luqadood |
vits |
LJSpeech plus 108 VCTK Af Ingiriisi | Af-ingiriis |
bark |
Generative TTS, 130 preset in 13 luqadood | kala duwan, soo bandhigida muujinaya (dhaqdhaqaaqa) |
openvoice |
Codka kloning iyo doorasho ah oo codka u beddelo | Ka bedelka Chatterbox |
chatterbox |
Zero-shot codka isku-dhafan ee 23 luqadood; codka default qaabka isbedelka | Ka-soo-celinta tusaale gaaban |
Erayada-in-teeg
| ID-ka qaabka | Tilmaamaha | Ugu Fiican |
|---|---|---|
whisper-large-v3 |
OpenAI Whisper Large v3 | Dhererka ugu sarreeya, luqado badan |
whisper-turbo |
Optimized Whisper si ay u degdeg ah | Faahfaahin |
Koodhadhka khaladaadka
| Koodka | _Xaaladda | Tilmaamaha |
|---|---|---|
invalid_api_key |
401 | Fadlan ku dar faahfaahinta |
insufficient_credits |
402 | Ma jiro credits ku filan hawlgalkaan |
rate_limit_exceeded |
429 | Dalabyo badan |
invalid_request |
400 | Jirka dalabka oo aan la qaabayn |
model_not_found |
404 | Nidaamka la dalbaday ma jiro |
voice_not_found |
404 | Codka la dalbaday ma jiro |
file_too_large |
413 | Faylka la soo dejiyey wuxuu ka badan yahay xaddiga xaddidaadda |
server_error |
500 | Xaaladda server-ka |