Cинхронное распознавание (HTTP)

Ответ выдается только после обработки всей аудиозаписи.

Максимальный размер аудио – 2 Мб, максимальная длина – одна минута. Для многоканального аудио распознается только первый канал.

POST HTTP-запрос отправляется по адресу:

https://smartspeech.sber.ru/rest/v1/speech:recognize

Запрос

Заголовки запроса

Наименование Описание

Authorization

Обязательное

Информация об аутентификации, переданная через OAuth 2.0

Bearer Access Token

Пример Bearer eyJhbGciOi.cCI6IkpXVCJ9.eyJzd.1hcnRzcG.KUkw

Content-Type

Обязательное

Формат данных, передаваемых в теле запроса

ASCII строка.
Возможные значения смотрите в разделе Доступные кодировки аудио

Параметры запроса

Наименование Описание

model

Название модели для распознавания речи

ASCII строка. Подробнее читайте в разделе Языковые модели

language

Язык для распознавания речи

ASCII строка, пока доступно только значение ru-RU

enable_profanity_filter

Фильтр обсценной лексики

boolean, значение по умолчанию false

channels_count

Количество каналов в многоканальном аудио.

Об ограничениях читайте в разделе Доступные кодировки аудио

Ответ

Тело HTTP-ответа содержит json с результатом распознавания речи, если запрос обработан успешно (код ответа 200).

Заголовки ответа

Наименование Описание

X-Request-ID

Обязательное

Уникальный ID запроса, генерируемый сервером

ASCII строка, 36 символов

22345200-abe8-4f60-90c8-0d43c5f6c0f6

Content-Type

Обязательное для статуса 200

Формат тела ответа сервиса

application/json

Формат ответа при успешном запросе

При успешном запросе вы получаете HTTP-код 200.

{"result": ["предложение №1", "предложение №2", ...], "status": 200}

Формат ответа при неуспешном запросе

Если запрос неуспешен, вы получаете HTTP-код, отличный от 200, с расширенным описанием ошибки в JSON-формате.

Код Описание

400

Ошибка в параметрах запроса

Пример {"status": 400, "message: <описание ошибки входящих параметров>}

401

Не предоставлен токен для аутентификации

Пример {"status": 401, "message": "Unauthorized"}

413

Превышен максимальный размер входных данных

Пример {"status": 413, "message": "Payload too large"}

429

Слишком много запросов

Пример {"status": 429, "message": "Too Many Requests"}

500

Внутренняя ошибка сервиса

Пример {"status": 500, "message": "Internal Server Error"|<описание ошибки ASR>"}

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней