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

Header
Authorization: Bearer YOUR_API_KEY
Tora yako API key kubva kune yako account dashboard.

Kutaura

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

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

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