Метод Synthesize

Примените метод Synthesize, чтобы преобразовать текст в речь по заданным параметрам без сохранения аудиофайла в библиотеку приложения. В результате вы получите аудио в формате base64. Для этого выполните POST-запрос с входными параметрами к точке подключения, указанными ниже.

Точка подключения:

POST: https://api.exolve.ru/media/v1/Synthesize

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Имя	Тип	Описание
Authorization	string	API-ключ приложения с `Bearer` перед ним. Пример: `Bearer e*s0`, где `e*s0` замените на API-ключ вашего приложения

Входные параметры

Передайте следующие параметры в теле запроса в JSON-формате. Параметры, выделенные жирным, обязательны.

Параметр	Тип	Описание
text	string	текст синтезируемой речи (от 1 до 500 символов, кодировка не учитывается)
voice_settings	VoiceSettings	голосовые настройки синтеза

VoiceSettings

Параметр	Тип	Описание
lang	array Lang	язык синтезируемой речи
voice	array Voice	голос для озвучивания текста
emotion	array Emotion	эмоция для озвучивания текста
speed	float	скорость синтезируемой речи (от 0.1 до 3.0, где 0.1 — самая медленная, 3.0 — самая быстрая, по умолчанию 1.0)
loudness_normalization	int32	нормализация громкости (от -145 до 0, где -145 — наименьшее (отрицательное) усиление, 0 — наибольшее (положительное) усиление громкости, по умолчанию -19)

Нормализация применяется, чтобы выровнять громкость синтезированной речи по сравнению с «живой» речью собеседников. LUFS — это единицы измерения громкости. Этот способ измерения объединяет воспринимаемую человеческим слухом громкость и истинную интенсивность аудиосигнала

Lang

Параметр	Тип	Язык
1	enum	русский (по умолчанию)
2	enum	английский
3	enum	немецкий
4	enum	иврит
5	enum	казахский
6	enum	узбекский

Voice

Параметр	Тип	Голос	Пол	Эмоция	Язык
1	enum	Алёна (по умолчанию)	Ж	1 — нейтральная (по умолчанию), 2 — добрая	1 — русский
2	enum	Ермил	М	1 — нейтральная (по умолчанию), 2 — радостная	1 — русский
3	enum	Джейн	Ж	1 — нейтральная (по умолчанию), 2 — радостная, 3 — раздраженная	1 — русский
4	enum	Омаж	Ж	1 — нейтральная (по умолчанию), 3 — раздраженная	1 — русский
5	enum	Захар	М	1 — нейтральная (по умолчанию), 2 — радостная	1 — русский
6	enum	Филипп	М	—	1 — русский
7	enum	Мадирус	М	—	1 — русский
8	enum	Даша	Ж	1 — нейтральная (по умолчанию), 2 — радостная, 4 — дружелюбная	1 — русский
9	enum	Юлия	Ж	1 — нейтральная (по умолчанию), 5 — строгая	1 — русский
10	enum	Лера	Ж	1 — нейтральная (по умолчанию), 4 — дружелюбная	1 — русский
11	enum	Марина	Ж	1 — нейтральная (по умолчанию), 4 — дружелюбная, 6 — шёпот	1 — русский
12	enum	Александр	М	1 — нейтральная (по умолчанию), 2 — радостная	1 — русский
13	enum	Кирилл	М	1 — нейтральная (по умолчанию), 2 — радостная, 5 — строгая	1 — русский
14	enum	Антон	М	1 — нейтральная (по умолчанию), 2 — радостная	1 — русский
15	enum	Маша	Ж	2 — радостная (по умолчанию), 4 — дружелюбная, 5 — строгая	1 — русский
16	enum	Лея	Ж	—	3 — немецкий
17	enum	Джон	М	—	2 — английский
18	enum	Наоми	Ж	7 — современный, 8 — классический	4 — иврит
19	enum	Амира	Ж	—	5 — казахский
20	enum	Мади	Ж	—	5 — казахский
21	enum	Нигора	Ж	—	6 — узбекский

Emotion

Параметр	Тип	Эмоция
1	enum	нейтральная
2	enum	радостная
3	enum	раздражённая
4	enum	дружелюбная
5	enum	строгая
6	enum	шёпот
7	enum	современная
8	enum	классическая

Выходные параметры

Параметр	Тип	Описание
file	bytes	готовое синтезированное аудио в формате base64
voice_settings	VoiceSettings	голосовые настройки синтеза — совпадают с входными параметрами

Возможные ошибки

Код	Статус	Пример сообщения	Описание
401	Unauthorized	failed to parse token	не указан или неправильно указан API-ключ приложения
404	Not Found		некорректно введен URL

Примеры

Входные параметры:

{
   "text": "МТС Exolve — конструктор омниканальных диалогов для бизнеса",
   "voice_settings": {
       "lang": 1,
       "voice": 1,
       "emotion": 1,
       "speed": 1,
       "loudness_normalization": -19
   }
}

Выходные параметры:

{
   "file": "UklGRl7XAABXQVZFZm",
   "voice_settings": {
       "lang": 1,
       "voice": 1,
       "emotion": 1,
       "speed": 1,
       "loudness_normalization": -19
   }
}