Сөйлеуді синтездеу
Мәтін жолдарын дыбыстау үшін сөйлеуді синтездеу функциясы қолданылады. Сөйлеуді синтездеу үшін https://voice.mcs.mail.ru/tts мекенжайына POST немесе GET сұрауын пайдаланыңыз.
GET
POST
GET сұрауы арқылы сөйлеуді синтездеу үшін мәтінді text параметрінде жіберіңіз.
Сұрау мысалы:
curl -L --request GET \--url 'https://voice.mcs.mail.ru/tts?text=<текст для озвучивания>' \--output <имя файла>--header 'Authorization: Bearer <токен доступа>'
Сұрау параметрлері:
Параметр | Сипаттамасы | Беру тәсілі | Рұқсат етілген мәндер |
|---|---|---|---|
model_name | Дауыс моделінің атауы | URL | katherine (немесе katherine-hifigan) — әдепкі бойынша; maria (немесе maria-serious); pavel (немесе pavel-hifigan) |
encoder | Энкодер түрі | URL | pcm — әдепкі бойынша; mp3; opus |
tempo | Сөйлеу жылдамдығы | URL | 0.75-тен 1.75-ке дейін |
text | Дыбыстауға арналған мәтін (GET сұрауы) | URL | UTF-8 пішімінде 2000 таңбаға дейін |
<текст для озвучивания> | Дыбыстауға арналған мәтін (POST сұрауы) | data опциясы | UTF-8 пішімінде 2000 таңбаға дейін |
<имя файла> | Кеңейтімі бар аудиофайл атауы | output опциясы | |
<токен доступа> | Авторизацияға арналған қолжетімділік токені. Авторизация туралы толығырақ Қолжетімділік токенін алу бөлімінде көрсетілген | header опциясы |
Сұрауда берілетін мәтін UTF-8 кодтауында болуы және 20000 таңбадан аспауы керек.
Жауапта таңдалған пішімдегі аудиофайл болады. Әдепкі бойынша PCM файлы жасалады.
Қайтарылатын PCM пішімінің параметрлері:
Параметр | Мәні |
|---|---|
audio | l16 |
rate | 24000 |
channels | 1 |
endianness | big-endian |
PCM-ді WAV-қа түрлендіру мысалы:
ffmpeg -f s16be -ar 24k -ac 1 -i test_sound7.pcm test_sound7.wav
Код | Күйі | Сипаттамасы |
|---|---|---|
4048 | 400 | Қате токен |
4049 | 400 | VK Cloud жобасы белсенді емес |
4051 | 14001 | Мәтін пішімі қате |