Работаем только на качество, выполняем постоянные обновления и улучшения функционала всего списка программ. По всем вопросам пишите нам

Главная / Информация

API text to speech – Инструкция

apihost author

API Host Company

2021-08-25

Для доступа к API необходимо пополнить баланс и скопировать Api_key.
Стоимость использования согласно общим тарифам.
API-ключ не имеют срока действия для простоты аутентификации, но в целях безопасности есть возможность перегенерировать ключ в личном кабинете.
Полученный API-ключ указывается в header для дальнейшей работы.

Получение списка голосов

Сначала получим список доступных голосов с доступными параметрами. Эти параметры потребуется для дальнейшей отправки текста на синтез.

Параметры:

‘server’=> ‘Сервер используемой нейросети 0-7, где 0 все голоса’

‘Authorization: Bearer <API-KEY>’


Пример:


Результат:

Результатом выполнения данного запроса будет список голосов:

“speaker”: [..] – Основные данные голоса.

“id” – Уникальный идентификатор голоса.

“speaker” – Имя голоса.

“lang” – Поддерживаемый язык.

“gender” – Принадлежность к мужскому или женскому полу.


“lang”: […] – Поддерживаемые языки всех голосов в данном сервисе.

“value” – ISO код языка.

“lang” – Наименование языка.


“emotion”: [..] – данный параметр определяет имеют ли голоса эмоциональный окрас в запрошенном сервисе, в случае отсутствия, пустой.


Отправка текста на синтез

После того как параметры интересующего голоса получены, можно выполнить отправку текста на сервер синтеза.

Параметры:

‘lang’=> ‘Язык голоса в формате ISO.’

‘speaker’=> ‘Уникальный идентификатор голоса.’

’emotion’=> ‘Эмоциональная окраска голоса, в случае отсутствия, пусто.’

‘text’=> ‘Текст который требуется озвучить’

‘rate’=> ‘Скорость чтения текста’

‘pitch’=> ‘Тон голоса’

‘type’=> ‘Выходной формат файла’

‘pause’=> ‘Длина паузы 0-5, “0” – без паузы. “1” – 0.1 сек. “2” – 0.2 сек. итд.’

‘Authorization: Bearer <API-KEY>’


Пример:


Результат:

Результатом успешного выполнения запроса получаем json формата:

Расшифровка полученного ответа в примере выше:

“status”:205 – Данный статус означает, что текст начал синтезироваться.

“process”:”s7uYvkRvK1″ – Уникальный идентификатор для запроса на проверку готовности файла.

“hold”:5686.17 – Остаток баланса.


Проверка готовности файла

Текст, отправленный на сервер, синтезируется от 5 секунд и более в зависимости от длины, загруженности сервера, и выбранной нейросети.

Для получения ссылки на готовый файла нужно периодически проверять задание на готовность.

Параметры:

‘process’=> ‘Уникальный идентификатор полученный при отправке запроса на синтез’

‘Authorization: Bearer <API-KEY>’


Пример:


Результат:

Результатом успешного выполнения запроса будет ссылка для скачивания озвученного текста.

Расшифровка полученного ответа в примере выше:

“status”:200 – Данный статус означает, что текст в речь успешно преобразован.

“message”:”https:\/\/apihost.ru\/storage\/tmp\/6125d3f2f3755467481224.mp3″ – Ссылка на готовый файл.


Если получен status 205 – файл не готов, пожалуйста, проверьте файл на готовность через 5 секунд.

Использование Text To Speech API позволяет озвучивать текст длиной до 1 000 000 символов. Озвучка происходит в потоковом режиме и может занимать от 5 секунд до нескольких минут в зависимости от длинны текста.

Готовый пример использования API на PHP