Xuquuqda API

Isticmaal Speech to Speech AI in codsiyadaada la API REST fudud.

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

Madaxa
Authorization: Bearer YOUR_API_KEY
Ka hel API-gaaga muhiimka ah xisaab dashboard.

Duubista Codka

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

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

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