Ҳужжатлар

Speech to Speech AI'ни оддий REST API'си билан дастурингизга интеграция қилинг.

Тез бошланиш

Speech to Speech AI API билан 5 дақиқа ичида ишлашни бошланг.

Манба URL
https://api.speechtospeechai.com/v1
1. Ишни бошлаш

Ҳар бир асбоб сизнинг API калитингиз билан POST'дир. Жавоб аудио эмас, иш ID'дир.

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. Натижа учун сўров

Ҳар бир иш учун ҳар бир дақиқада, ҳолат тугагунча, савол бериш, сўнгра 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"}

Тасдиқлаш

Барча API талаблари учун қуйидаги API калит орқали аутентификация талаб этилади Authorization бошлиқ.

Бош саҳифа
Authorization: Bearer YOUR_API_KEY
API калитингизни ўзингизнинг ҳисоб панели.

Товушни клонлаш

POST /v1/voice-clone/

Текстни қисқа мисол ёзув овози билан гапиринг.

Со'ровнинг боши (кўп қисмли/форм-маълумот)
Парамeтрлар Тури Кўрсатма Тасвирлаш
reference_audio file Ҳа Клонлаш учун овоз ёзиш (10-30 секунд тавсия этилади, 60 гача)
text string Ҳа Ушбу овозда айтиладиган матн
model string Йўқ chatterbox, openvoice, tortoise ёки gpt-sovits
language string Йўқ Тил коди (одатдаги: en)
Жавоб

Иш ID (uuid). Ҳолат тугагунча ва result_url юклаб олгунча Poll GET /v1/speech/results/?uuid=.

Матндан сўзга

POST /v1/tts/

Матнни сўзлашув аудиосига айлантириш.

Со'ровнинг боши (кўп қисмли/форм-маълумот)
Парамeтрлар Тури Кўрсатма Тасвирлаш
text string Ҳа Ўгириладиган матн (максимум 5000 белги)
model string Йўқ kokoro (стандарт), piper, vits ёки bark
voice_id string Йўқ /v1/speech/voices/?model= дан овоз ID'ни олиш
language string Йўқ Тил коди (одатдаги: en)
speed float Йўқ Тезлик кўпайтиргичи (0.5-2.0, олдинги 1.0)
format string Йўқ wav (стандарт), mp3, ogg ёки flac. SSML теглари синтезлашдан олдин олиб ташланади.
Жавоб

Иш ID (uuid). Ҳолат тугагунча ва result_url юклаб олгунча Poll GET /v1/speech/results/?uuid=.

Матнга сўзлаш

POST /v1/transcribe/

Аудиоларни вақт белгилари билан матнга кўчириш.

Со'ровнинг боши (кўп қисмли/форм-маълумот)
Парамeтрлар Тури Кўрсатма Тасвирлаш
file file Ҳа Транскрипция қилинадиган аудио/видео файл
model string Йўқ катта-v3 (одатдаги) ёки турбо
language string Йўқ Тил коди, ёки уни автоматик аниқлаш (одатдаги)
enable_word_timestamps bool Йўқ Ҳар бир сўзга бошланиш ва тугатиш вақтини қўшиш
callback_url string Йўқ Иш тугаганида POST орқали натижани оладиган URL
Жавоб

Иш ID (uuid). Ҳолат тугагунча GET /v1/transcribe/results/?uuid= сўровини бажаринг; жавоб матн, тил ва сегментларни олиб юради.

Қоладиган моделлар

Матн-сўз моделлари
Модель ID Тасвирлаш Энг яхши
kokoro Тез кўп тилли TTS Умумий фойдаланиш, паст кечикиш
piper Оғирлиги кам кўп тилли TTS (фақат лицензияланган овозлар) 11 тилда тезкор тасвирлаш
vits LJSpeech плюс 108 VCTK инглиз тилидаги сўзловчилар Инглиз акцентлари
bark Генерация TTS, 13 тилда 130 та олдиндан ўрнатилган Кўп хил, ифодали тақдим этиш (секин)
openvoice Товушни клонлаш ва қўшимча овозни ўзгартириш Chatterbox'га альтернатива
chatterbox 23 тилда овозни клонлаш; овозни конвертация қилишнинг стандарт модели Қисқа намунадан клонлаш
Сўздан матнга моделлар
Модель ID Тасвирлаш Энг яхши
whisper-large-v3 OpenAI Whisper Large v3 Энг юқори аниқлик, кўп тилли
whisper-turbo Тезлик учун Whisper оптималлаштирилган Тез транскрипция

Хато кодлари

Код Ҳолат Тасвирлаш
invalid_api_key 401 Нодуруст ёки йўқ API калит
insufficient_credits 402 Бу операция учун етарли кредитлар йўқ
rate_limit_exceeded 429 Жуда кўп талаблар
invalid_request 400 Хато шаклланган илтимос тана
model_not_found 404 Соратилган модел мавжуд эмас
voice_not_found 404 Соратилган овоз мавжуд эмас
file_too_large 413 Юкланган файл ҳажми чекланган
server_error 500 Сервернинг ички хатоси