Sened

Speech to Speech AI-i öz programleriňe ýönekeý REST API bilen birleşdir.

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

Başlyg
Authorization: Bearer YOUR_API_KEY
API adyny öz hasap.

Ses

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

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

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