Ҳуҷҷатҳо

Speech to Speech AI-ро бо барномаҳои худ бо API-и оддии REST муттаҳид кунед.

Оғози тез

Бо API-и Speech to Speech AI дар муддати 5 дақиқа оғоз кунед.

URL- и асосӣ
https://api.speechtospeechai.com/v1
1. Оғози масъала

Ҳар як асбоб POST бо калиди API- и шумо мебошад. Ҷавоб - ин идентификатори кор, на аудио.

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/

Матнро бо овози сабти муфассали кӯтоҳ гӯед.

Дархости танзимот
& Параметрҳо & Навъ Дархостӣ & Тасвирот
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

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

POST /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 Хатои дохилӣ дар сервер