Ҳужжатлар
Speech to Speech AI'ни оддий REST API'си билан дастурингизга интеграция қилинг.
Тез бошланиш
Speech to Speech AI API билан 5 дақиқа ичида ишлашни бошланг.
Манба URL
https://api.speechtospeechai.com/v1
1. Ишни бошлаш
Ҳар бир асбоб сизнинг API калитингиз билан POST'дир. Жавоб аудио эмас, иш ID'дир.
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 "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
Товушни клонлаш
/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=.
Матндан сўзга
/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=.
Матнга сўзлаш
/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 | Сервернинг ички хатоси |