Синтез речи с Postman

Обновлено 24 декабря 2024

C помощью Postman вы можете работать с API синтеза речи SaluteSpeech.

Подробнее о том, как получить токен доступа и начать работу с Postman — в разделе Коллекции запросов Postman.

Синхронный синтез речи

Вы можете синхронно синтезировать речь с помощью Postman.

Максимальный размер запроса — 4 000 символов, включая пробелы и SSML-разметку.

Результат можно скачать в форматах: WAV16, PCM16 или OPUS.

Чтобы в Postman загрузить текст, который нужно озвучить:

1. Скопируйте коллекцию Postman и получите новый токен (подробнее — в разделе Получение токена). Токен действует 30 минут.
2. В коллекции SaluteSpeech откройте папку Синтез (до 4 тыс.), SSML есть и выберите метод synthesis.
3. На вкладке Params выберите и отметьте галочками формат аудиофайла и голос. Голоса можно послушать в разделе Примеры голосов.
4. На вкладке Body введите текст для синтеза.
5. Нажмите Send.
6. Над полем ответа в нижней части экрана нажмите иконку меню и выберите Save response to file.
7. При выборе папки на компьютере укажите формат файла: WAV16, PCM16 или OPUS.

Подробнее о том, как пользоваться SSML-разметкой — в разделе Как улучшить синтез с SSML-разметкой.

Асинхронный синтез речи

Вы можете асинхронно синтезировать речь с помощью Postman.

Максимальный размер запроса — 1 000 000 символов, включая пробелы. SSML-разметка недоступна.

Результат скачивается в формате OPUS.

Загружаем текст

Загрузите текст, который нужно озвучить, в формате .txt.

Для этого:

1. Скопируйте коллекцию Postman и получите новый токен (подробнее — в разделе Получение токена). Токен действует 30 минут.
2. В коллекции SaluteSpeech откройте папку Синтез (до 1 млн.), SSML-разметки нет и выберите запрос upload.
3. На вкладке Body нажмите Select File и загрузите текстовый файл для синтеза.
4. Нажмите Send.

В случае успеха в нижней части экрана вам отобразится код со статусом 200 и идентификатором загруженного файла. Например:

{
    "status": 200,
    "result": {
        "request_file_id": "2345200-abe8-4f60-90c8-0d43c5f6c0f6"
    }
}

Создаем задачу на синтез

Чтобы создать задачу на синтез загруженного текста:

1. В папке Синтез (до 1 млн.), SSML нет выберите запрос synthesis.
2. Нажмите Send.

В случае успеха в нижней части экрана вам отобразится код со статусом NEW. Например:

{
    "status": 200,
    "result": {
        "id": "dafaf982-a32a-4e26-ae40-2bb9444906e1",
        "created_at": "2021-07-15T17:35:17.182454861+03:00",
        "updated_at": "2021-07-15T17:35:17.18245504+03:00",
        "status": "NEW"
    }
}

Проверяем статус задачи

Чтобы проверить статус задачи:

1. В папке Синтез (до 1 млн.), SSML нет выберите запрос status.
2. Нажмите Send.

В случае успеха в ответе вам отобразится код со статусом DONE и идентификатором файла с результатом синтеза. Например:

{
    "status": 200,
    "result": {
        "id": "dafaf982-a32a-4e26-ae40-2bb9444906e1",
        "created_at": "2021-07-15T17:35:17.182454861+03:00",
        "updated_at": "2021-07-15T17:35:57.18245504+03:00",
        "status": "DONE",
        "response_file_id": "2d45b5dc-73fe-40b1-9c89-0eea703036e5"
    }
}

Если статус задачи RUNNING, значит она еще обрабатывается, попробуйте проверить статус еще раз позже.

Скачиваем результат

Чтобы скачать результат синтеза:

1. В папке Синтез (до 1 млн.), SSML нет выберите запрос download.
2. Нажмите Send.
3. Нажмите иконку меню над полем ответа и выберите Save response to file.
4. При выборе папки на компьютере укажите формат файла — OPUS.

Если не получилось выбрать формат файла при скачивании, то поменяйте формат уже на компьютере.