Распознавание речи с Postman

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

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

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

Загружаем аудиофайл

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

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

Максимальный размер аудиофайла — 1 Гб.

4. Нажмите Send.

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

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

Создаем задачу на распознавание

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

1. В папке Распознавание (до 1 Гб) выберите запрос recognize.
2. На вкладке Body отредактируйте параметры:
   1. model — значение callcenter, если частота аудиофайла — 8кГц, и general — для всех остальных.
   2. audio_encoding — кодировка аудиофайла.
   3. sample_rate — частота дискретизации аудио.
   4. channels_count — количество каналов в аудио.
3. Нажмите 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 Гб) выберите запрос 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 Гб) выберите запрос download.
2. Нажмите Send.
3. Нажмите иконку меню над полем ответа и выберите Save response to file.

На вкладке Visualize можно посмотреть результаты распознавания в виде таблицы. Вы можете отредактировать представление на вкладке Test.