Оғози тез
Бо API-и Speech to Speech AI дар муддати 5 дақиқа оғоз кунед.
URL- и асосӣ
https://api.speechtospeechai.com/v1
1. Оғози масъала
Ҳар як асбоб POST бо калиди API- и шумо мебошад. Ҷавоб - ин идентификатори кор, на аудио.
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/
Матнро бо овози сабти муфассали кӯтоҳ гӯед.
Дархости танзимот
| & Параметрҳо | & Навъ | Дархостӣ | & Тасвирот |
|---|---|---|---|
reference_audio |
file | & Тасвир | Сабт кардани овоз барои нусхабардорӣ (10-30 сония тавсия дода мешавад, то 60) |
text |
string | & Тасвир | Матн барои талаффуз бо ин овоз |
model |
string | & Намоиши хатҳои равон | chatterbox, openvoice, tortoise ё gpt-sovits |
language |
string | & Намоиши хатҳои равон | Рамзи забон (бо нобаёнӣ: en) |
Ҷавоб
Идентификатори кор (uuid). То ба итмом расидани ҳолати пурра ва боргирии result_url, пурсиш GET /v1/speech/results/?uuid=.
Text to Speech
/v1/tts/
Тағйири матн ба овоз
Дархости танзимот
| & Параметрҳо | & Навъ | Дархостӣ | & Тасвирот |
|---|---|---|---|
text |
string | & Тасвир | Матни табдилшаванда (максимум 5000 аломат) |
model |
string | & Намоиши хатҳои равон | kokoro (бо нобаёнӣ), piper, vits ё bark |
voice_id |
string | & Намоиши хатҳои равон | Идентификатори овоз аз GET /v1/speech/voices/?model= |
language |
string | & Намоиши хатҳои равон | Рамзи забон (бо нобаёнӣ: en) |
speed |
float | & Намоиши хатҳои равон | Speed multiplier (0.5-2.0, default 1.0) |
format |
string | & Намоиши хатҳои равон | wav (бо нобаёнӣ), mp3, ogg ё flac. SSML тегҳо пеш аз синтез хориҷ карда мешаванд. |
Ҷавоб
Идентификатори кор (uuid). То ба итмом расидани ҳолати пурра ва боргирии result_url, пурсиш GET /v1/speech/results/?uuid=.
Гузаронидани матнComment
/v1/transcribe/
Тағйири аудио ба матн бо нишонаҳои вақт
Дархости танзимот
| & Параметрҳо | & Навъ | Дархостӣ | & Тасвирот |
|---|---|---|---|
file |
file | & Тасвир | Файли аудио/видео барои гузарондан |
model |
string | & Намоиши хатҳои равон | калон- v3 (бо нобаёнӣ) ё турбо |
language |
string | & Намоиши хатҳои равон | Рамзи забон, ё худмуайянкунии он (бо нобаёнӣ) |
enable_word_timestamps |
bool | & Намоиши хатҳои равон | Иловаи вақти оғоз ва анҷом ба ҳар як калима |
callback_url |
string | & Намоиши хатҳои равон | URL, ки натиҷаро бо POST ҳангоми анҷоми кор қабул мекунад |
Ҷавоб
Идентификатори кор (uuid). Тафтиши GET /v1/transcribe/results/?uuid= то он даме, ки ҳолати пурра ба итмом расад; ҷавоб матн, забон ва қисмҳоро дар бар мегирад.
Намунаҳои дастрас
Матни ба гуфтугӯи моделҳо
| Идентификатори намуна | & Тасвирот | Беҳтарин барои |
|---|---|---|
kokoro |
Тезкор бисёрзабони TTS | Истифодаи умумӣ, таъхири паст |
piper |
Барномаи TTS-и бисёрзабони сабук (танҳо овозҳои бо иҷозатномаи тиҷоратӣ) | Тез ба 11 забон |
vits |
LJSpeech ва 108 VCTK- и англисӣ | Забонҳои Англисӣ |
bark |
Генератори TTS, 130 пешфарз дар 13 забон | Тағйирёбанда, ифодакунандаи диҳиш (зуд) |
openvoice |
Тасвири овоз ва табдилдиҳии овози ихтиёрӣ | Alternative to Chatterbox |
chatterbox |
Нуқтаи 0-и клонкунии овоз дар 23 забон; модели пешфарзии табдилдиҳии овоз | Тақсимкунӣ аз намунаи кӯтоҳ |
Speech-to-Text Models
| Идентификатори намуна | & Тасвирот | Беҳтарин барои |
|---|---|---|
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 | Хатои дохилӣ дар сервер |