Tiz Başlanç
Speech to Speech AI API bilen 5 minutda başla
Esas URL.
https://api.speechtospeechai.com/v1
1. Bir iş başla
Her bir esbap siziň API açaryňyz bilen POST'dir. Jawaby iş id'dir, ses däl.
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. Netijä üçin sora
Her bir sagatda bir iş sora, status tamamlanana çenli, soňra result_url'i ýükle.
curl "https://api.speechtospeechai.com/v1/speech/results/?uuid=3f2c..." \
-H "Authorization: Bearer YOUR_API_KEY"
{"status": "completed", "result_url": "https://.../output.mp3"}
Tanyşlyk
Ehli API soraglar şunda bir API adyny ulanyp tanyşlyk talap edýärler Authorization başlyk
Authorization: Bearer YOUR_API_KEY
Ses
/v1/voice-clone/
Metinleri gysga reňk ýazgyda söz bilen aýt
Sorag Bedeni (çok bölegi/şekil-datany)
| Parametr | _Täze | Gerekli | _Aýdym |
|---|---|---|---|
reference_audio |
file | Eý | Klonlamak üçin sesiň ýazgysyny (10-30 sekunt maslahat berilýär, 60'e çenli) |
text |
string | Eý | Bu ses bilen aýtmak üçin metin |
model |
string | _Ýok | chatbox, openvoice, tortoise ýa-da gpt-sovits |
language |
string | _Ýok | Dil kody (öň bellenen: en) |
Jawaby
Bir iş id (uuid). Poll GET /v1/speech/results/?uuid= till status is completed and download result_url.
Metinden Söze
/v1/tts/
Metini söze öwür
Sorag Bedeni (çok bölegi/şekil-datany)
| Parametr | _Täze | Gerekli | _Aýdym |
|---|---|---|---|
text |
string | Eý | Çevirjek bolýan metin (maksimum 5000 simwol). |
model |
string | _Ýok | kokoro (öň bellenen), piper, vits ýa-da bark |
voice_id |
string | _Ýok | Ses id'i GET /v1/speech/voices/?model='den |
language |
string | _Ýok | Dil kody (öň bellenen: en) |
speed |
float | _Ýok | Tizlik katlaýyjy (0.5-2.0, öň bellenen 1.0) |
format |
string | _Ýok | wav (öň bellenen), mp3, ogg ýa flac. SSML taglar sintezden öň aýyrylýar. |
Jawaby
Bir iş id (uuid). Poll GET /v1/speech/results/?uuid= till status is completed and download result_url.
Sözden metin
/v1/transcribe/
Sesleri wagt möhürleri bilen metinlere geçir
Sorag Bedeni (çok bölegi/şekil-datany)
| Parametr | _Täze | Gerekli | _Aýdym |
|---|---|---|---|
file |
file | Eý | Öňki faýl |
model |
string | _Ýok | uly-v3 (öň bellenen) ýa-da turbo |
language |
string | _Ýok | Dil ködi, ýa-da ony awtomatik tapmak üçin (öň bellenen) |
enable_word_timestamps |
bool | _Ýok | Her bir söze bir başlaýş we bitiş wagty ekle |
callback_url |
string | _Ýok | Iş tamamlananda POST bilen netijäni alan URL |
Jawaby
Bir iş id (uuid). Status tamamlanana çenli sora GET /v1/transcribe/results/?uuid=; jogap soňra metin, dil we segmentleri alyp barýar.
Elýeterli Modyllar
Metinden-söze Modyller
| Model ID | _Aýdym | Iň gowy |
|---|---|---|
kokoro |
Çylşyrymly dil | Umumy ullanyş, az wagtlyk |
piper |
Ýüksek tizlikli köp dilli TTS (diňe söwda lisenziýaly sesler) | 11 dilde tiz render eder |
vits |
LJSpeech wekilinde 108 VCTK inglizçe söwda edijiň ýokary sesleri bar. | Ingliz aksentleri |
bark |
TTS, 13 dillerde 130 öň bellenen | Çykyş |
openvoice |
Ses klonlama we opsion ses öwürme | Çat Boçka |
chatterbox |
23 dilde ses klonlamak; öň bellenen ses öwürmek modeli | Bir gysga mysaldan klonlamak |
Sözden metine modyller
| Model ID | _Aýdym | Iň gowy |
|---|---|---|
whisper-large-v3 |
OpenAI Whisper Large v3 | Ençeme dil |
whisper-turbo |
Tizlik üçin optimizirlen Whisper | Tiz transkript |
Hata Kody
| Kod | _Iňlisçe | _Aýdym |
|---|---|---|
invalid_api_key |
401 | Saýlawy nädogry ýa-da ýok |
insufficient_credits |
402 | Bu iş üçin ýeterlik kreditler ýok |
rate_limit_exceeded |
429 | Çok talaplar |
invalid_request |
400 | Soragyň özüne nädogry şekilli |
model_not_found |
404 | Soran mody ýok |
voice_not_found |
404 | Soran ses ýok |
file_too_large |
413 | Faýl ýüklenildi |
server_error |
500 | Serwer hatasy |