SPR. Руководство пользователя - История изменений

KorolkovS в 07:57, 29 января 2026

2026-01-29T07:57:36Z

← Предыдущая версия		Версия от 10:57, 29 января 2026
Строка 106:		Строка 106:
	* <small>'''async''' — отложенный запуск распознавания</small>		* <small>'''async''' — отложенный запуск распознавания</small>
	* <small>'''classifiers'''<nowiki> - дополнительно проанализировать все распознанные фразы через модели smc и/или see. отправляется в виде {"smс":"название модели":{ параметры запроса }}. Подробнее о параметрах запроса см. в документации по сервисам </nowiki>[[SMC. Руководство пользователя\|smc]] и [[SEE. Руководство пользователя\|see]].</small>		* <small>'''classifiers'''<nowiki> - дополнительно проанализировать все распознанные фразы через модели smc и/или see. отправляется в виде {"smс":"название модели":{ параметры запроса }}. Подробнее о параметрах запроса см. в документации по сервисам </nowiki>[[SMC. Руководство пользователя\|smc]] и [[SEE. Руководство пользователя\|see]].</small>
			* <small>'''webhook''' — внешний url для отправки результата распознавания в отложенном режиме запуска. Результат отправляется методом POST.</small>

	\| style="width: 50%" \|<small>В случае '''async=1''' возвращается только '''taskID''', результат по taskID смотреть в методе /spr/result.</small>		\| style="width: 50%" \|<small>В случае '''async=1''' возвращается только '''taskID''', результат по taskID смотреть в методе /spr/result либо на внешнем сервисе, указанном в поле webhook.</small>
	<small>'''Для коротких файлов''':</small>		<small>'''Для коротких файлов''':</small>

KorolkovS в 08:01, 12 января 2026

2026-01-12T08:01:41Z

← Предыдущая версия		Версия от 11:01, 12 января 2026
Строка 19:		Строка 19:
	Ответ сервиса представляет собой JSON-документ в кодировке UTF-8 или двоичный файл. Содержимое документа зависит от результата выполнения запроса. При наличии ошибки в качестве ответа вернется переменная error=1 и описание в переменной message. Для удобства проверки методов по ссылке http://АДРЕС:6183 будет отображен интерфейс Swagger со всеми методами с возможностью их проверки.		Ответ сервиса представляет собой JSON-документ в кодировке UTF-8 или двоичный файл. Содержимое документа зависит от результата выполнения запроса. При наличии ошибки в качестве ответа вернется переменная error=1 и описание в переменной message. Для удобства проверки методов по ссылке http://АДРЕС:6183 будет отображен интерфейс Swagger со всеми методами с возможностью их проверки.

			<onlyinclude>
	{\| class="wikitable" style="width: 110%"		{\| class="wikitable" style="width: 110%"
	\|+		\|+
Строка 261:		Строка 262:
	<small><code>}</code></small>		<small><code>}</code></small>
	\|}		\|}
			</onlyinclude>

KorolkovS в 07:57, 12 января 2026

2026-01-12T07:57:25Z

Ka.shapovalov в 10:00, 27 августа 2025

2025-08-27T10:00:27Z

← Предыдущая версия		Версия от 13:00, 27 августа 2025
Строка 102:		Строка 102:
	* <small>'''emotion''' — выявить эмоции из распознанного текста через smc (GET/smc/emotion). Возможные ответы: negative, neutral, positive.</small>		* <small>'''emotion''' — выявить эмоции из распознанного текста через smc (GET/smc/emotion). Возможные ответы: negative, neutral, positive.</small>
	* <small>'''voice_analyzer''' — анализировать аудиофрагменты каждого из говорящих на эмоции, возраст и пол, запрашивается в sbs метод POST/sbs/analyze.</small><small>Аудио говорящего анализируется на возраст (child, adult, old).</small><small>Эмоции (ANGER, BORE, DISAPPOINTMENT, DISGUST, EXCITEMENT, FEAR, NEUTRAL, PAIN, PLEASURE, SADNESS, SUPRISE).</small> <small>Пол (male, female).</small>		* <small>'''voice_analyzer''' — анализировать аудиофрагменты каждого из говорящих на эмоции, возраст и пол, запрашивается в sbs метод POST/sbs/analyze.</small><small>Аудио говорящего анализируется на возраст (child, adult, old).</small><small>Эмоции (ANGER, BORE, DISAPPOINTMENT, DISGUST, EXCITEMENT, FEAR, NEUTRAL, PAIN, PLEASURE, SADNESS, SUPRISE).</small> <small>Пол (male, female).</small>
	* <small>'''speaker_counter''' — количество докладчиков, по умолчанию 0, автоматическое определение количества</small>		* <small>'''speaker_counter''' — количество докладчиков, по умолчанию 0, автоматическое определение количества. При отправке значения -1 разделение на докладчиков будет отключено.</small>
	* <small>'''async''' — отложенный запуск распознавания</small>		* <small>'''async''' — отложенный запуск распознавания</small>
	* <small>'''classifiers'''<nowiki> - дополнительно проанализировать все распознанные фразы через модели smc и/или see. отправляется в виде {"smс":"название модели":{ параметры запроса }}. Подробнее о параметрах запроса см. в документации по сервисам </nowiki>[[SMC. Руководство пользователя\|smc]] и [[SEE. Руководство пользователя\|see]].</small>		* <small>'''classifiers'''<nowiki> - дополнительно проанализировать все распознанные фразы через модели smc и/или see. отправляется в виде {"smс":"название модели":{ параметры запроса }}. Подробнее о параметрах запроса см. в документации по сервисам </nowiki>[[SMC. Руководство пользователя\|smc]] и [[SEE. Руководство пользователя\|see]].</small>

Ka.shapovalov в 08:24, 27 августа 2025

2025-08-27T08:24:32Z

← Предыдущая версия		Версия от 11:24, 27 августа 2025
Строка 90:		Строка 90:
	\|-		\|-
	!style="color:green;width: 15%"\|'''POST:/spr/stt/{id}'''		!style="color:green;width: 15%"\|'''POST:/spr/stt/{id}'''
	! colspan="3" \|<small>Отправка файла на распознавание речи. Моно-файлы до 30 секунд распознаются без разбивки на фрагменты. Многоканальные файлы и файлы длиннее 30 секунд предварительно разбиваются на фрагменты по отсутствию речи. Настройка данных параметров описана в [[SPR. Руководство администратора.\|руководстве администратора]].</small>		! colspan="3" \|<small>Отправка файла на распознавание речи. Моно-файлы до 60 секунд распознаются без разбивки на фрагменты и определения спикеров. Многоканальные файлы и файлы длиннее 60 секунд предварительно разбиваются на фрагменты по отсутствию речи. Настройка данных параметров описана в [[SPR. Руководство администратора.\|руководстве администратора]].</small>
	\|-		\|-
	\| colspan="3" style="width: 50%" \|		\| colspan="3" style="width: 50%" \|

Ka.shapovalov в 05:22, 3 июля 2025

2025-07-03T05:22:46Z

← Предыдущая версия		Версия от 08:22, 3 июля 2025
Строка 113:		Строка 113:
	<small><code> "model": "call",</code></small>		<small><code> "model": "call",</code></small>

	<small><code> "text": "текст ~~фрагментв~~",</code></small>		<small><code> "text": "текст фрагмента",</code></small>

			<code><small>"classifiers": тут ответы от моделей smc и see,</small></code>

	<code><small> "words": [</small><small> </small></code>		<code><small> "words": [</small><small> </small></code>

Ka.shapovalov в 05:21, 3 июля 2025

2025-07-03T05:21:45Z

← Предыдущая версия		Версия от 08:21, 3 июля 2025
Строка 93:		Строка 93:
	\|-		\|-
	\| colspan="3" style="width: 50%" \|		\| colspan="3" style="width: 50%" \|
	* <small>id — идентификатор модели</small>		* <small>'''id''' — идентификатор модели</small>
	* <small>wav — файл для распознавания</small>		* <small>'''wav''' — файл для распознавания</small>
	* <small>speakers — опция поиска говорящих по базе SBS</small>		* <small>'''speakers''' — опция поиска говорящих по базе SBS. Если 1, то дополнительно производится поиск говорящих и получение метаданных по каждому говорящему (используется сервис SBS с предварительно обученными слепками метаданных говорящих)</small>
	* <small>punctuation — опция для расстановки знаков препинания</small>		* <small>'''punctuation''' — опция для расстановки знаков препинания. Если 1, то дополнительно вызывает метод punctuate в SMC и расставляет знаки препинания в распознанном тексте, значение по умолчанию берётся из файла конфигурации (для модели big пунктуация выполняется в любом случае).</small>
	* <small>normalization — опция обратной нормализации текста</small>		* <small>'''normalization''' — опция обратной нормализации текста, если 1, то выполняется обратная нормализация текста текста (для модели big выполняется в любом случае).</small>
	* <small>vad — используемый VAD, по умолчанию webrtc</small>		* <small>'''vad''' — используемый VAD, по умолчанию webrtc</small>
	* <small>toxicity — анализировать распознанный текст на токсичность</small>		* <small>'''toxicity''' — анализировать распознанный текст на токсичность через smc (GET/smc/toxicity).</small><small>Высказывание анализируется по 4 параметрам, по каждому выдается вероятность от 0 до 1:</small><small>"оскорбление": 0.13,</small> <small>"непристойность": 0,</small> <small>"угроза": 0,</small> <small>"вежливость": 0.53</small>
	* <small>emotion — выявить эмоции из распознанного текста</small>		* <small>'''emotion''' — выявить эмоции из распознанного текста через smc (GET/smc/emotion). Возможные ответы: negative, neutral, positive.</small>
	* <small>voice_analyzer — анализировать аудиофрагменты каждого из говорящих на эмоции, возраст и пол</small>		* <small>'''voice_analyzer''' — анализировать аудиофрагменты каждого из говорящих на эмоции, возраст и пол, запрашивается в sbs метод POST/sbs/analyze.</small><small>Аудио говорящего анализируется на возраст (child, adult, old).</small><small>Эмоции (ANGER, BORE, DISAPPOINTMENT, DISGUST, EXCITEMENT, FEAR, NEUTRAL, PAIN, PLEASURE, SADNESS, SUPRISE).</small> <small>Пол (male, female).</small>
	* <small>speaker_counter — количество докладчиков, по умолчанию 0, автоматическое определение количества</small>		* <small>'''speaker_counter''' — количество докладчиков, по умолчанию 0, автоматическое определение количества</small>
	* <small>async — отложенный запуск распознавания.</small>		* <small>'''async''' — отложенный запуск распознавания</small>
			* <small>'''classifiers'''<nowiki> - дополнительно проанализировать все распознанные фразы через модели smc и/или see. отправляется в виде {"smс":"название модели":{ параметры запроса }}. Подробнее о параметрах запроса см. в документации по сервисам </nowiki>[[SMC. Руководство пользователя\|smc]] и [[SEE. Руководство пользователя\|see]].</small>




	<small>В случае отправки переменной '''speakers=1''', дополнительно производится поиск говорящих и получение метаданных по каждому говорящему (используется сервис SBS с предварительно обученными слепками метаданных говорящих). В случае отправки переменной '''punctuation=1''', дополнительно вызывает метод punctuate в SMC и расставляет знаки препинания в распознанном тексте (значение по умолчанию берётся из файла конфигурации). '''normalization=1''' для обратной нормализации текста. В случае использования модели BIG параметры punctuation и normalization игнорируются — модель всегда расставляет знаки препинания и нормализует текст.</small>

	~~<small>При установке параметра '''toxicity''' запрашивается в smc метод GET/smc/toxicity</small>~~

	~~<small>Высказывание анализируется по 4 параметрам, по каждому выдается вероятность от 0 до 1:</small>~~

	~~<small>"оскорбление": 0.13,</small>~~

	~~<small>"непристойность": 0,</small>~~

	~~<small>"угроза": 0,</small>~~

	~~<small>"вежливость": 0.53</small>~~

	~~<small>При установке параметра '''emotion''' запрашивается в smc метод GET/smc/emotion</small>~~

	~~<small>Высказывание анализируется на эмоциональность (negative, neutral, positive)</small>~~

	~~<small>При установке параметра '''voice_analyzer''' запрашивается в sbs метод POST/sbs/analyze.</small>~~

	~~<small>Аудио говорящего анализируется на возраст (child, adult, old).</small>~~

	~~<small>Эмоции (ANGER, BORE, DISAPPOINTMENT, DISGUST, EXCITEMENT, FEAR, NEUTRAL, PAIN, PLEASURE, SADNESS, SUPRISE).</small>~~

	~~<small>Пол (male, female).</small>~~
	\| style="width: 50%" \|<small>В случае '''async=1''' возвращается только '''taskID''', результат по taskID смотреть в методе /spr/result.</small>		\| style="width: 50%" \|<small>В случае '''async=1''' возвращается только '''taskID''', результат по taskID смотреть в методе /spr/result.</small>
	<small>'''Для коротких файлов''':</small>		<small>'''Для коротких файлов''':</small>
Строка 221:		Строка 194:

	<small><code> "speakerConfidence": 0.87,</code></small>		<small><code> "speakerConfidence": 0.87,</code></small>

			<code><small>"classifiers": тут ответы от моделей smc и see,</small></code>

	<small><code> "toxicity": { # только для toxicity=1</code></small>		<small><code> "toxicity": { # только для toxicity=1</code></small>

E.Elagina: /* Общее описание */

2025-02-20T07:42:49Z

Общее описание

Внесённые изменения

V.Kazantsev: /* Описание методов API SPR */

2025-02-17T17:42:48Z

Описание методов API SPR

← Предыдущая версия		Версия от 20:42, 17 февраля 2025
Строка 105:		Строка 105:

	* <small>'''vad''' - используемый VAD, по умолчанию webrtc</small>		* <small>'''vad''' - используемый VAD, по умолчанию webrtc</small>

	* <small>'''preset''' - используемая модель для vad = neuro</small>

	* <small>'''toxicity''' - анализировать распознанный текст на токсичность</small>		* <small>'''toxicity''' - анализировать распознанный текст на токсичность</small>

E.Elagina: /* Общее описание */

2025-02-06T07:52:54Z

Общее описание

← Предыдущая версия		Версия от 10:52, 6 февраля 2025
Строка 8:		Строка 8:
	Модель — предварительно обученная специализированная нейронная сеть для распознавания естественной речи в аудиозаписях.		Модель — предварительно обученная специализированная нейронная сеть для распознавания естественной речи в аудиозаписях.

	Swagger UI – интерактивная веб-консоль с кратким описанием методов ~~АPI~~ и возможностью выполнять запросы к сервису SPR в реальном времени		Swagger UI – интерактивная веб-консоль с кратким описанием методов API и возможностью выполнять запросы к сервису SPR в реальном времени

← Предыдущая версия		Версия от 10:57, 12 января 2026
Строка 22:		Строка 22:
	\|+		\|+
	\|-		\|-
	! style="color:blue;width: 15%"\|'''GET:/spr/'''		! style="color:blue;width: 15%"\|'''GET:/spr/models'''
	! colspan="3" \|<small>Вывод списка моделей.</small>		! colspan="3" \|<small>Вывод списка моделей.</small>
	\|-		\|-
Строка 34:		Строка 34:
	\|<small>Файл аудиозаписи или</small> <small><code>{ error: INT , message: DESCRIPTION }</code></small>		\|<small>Файл аудиозаписи или</small> <small><code>{ error: INT , message: DESCRIPTION }</code></small>
	\|-		\|-
	! style="color:blue;width: 15%"\|'''GET:/spr/~~data~~/{id}'''		! style="color:blue;width: 15%"\|'''GET:/spr/export/{id}'''
	! colspan="3" \|<small>Получение архива модели.</small>		! colspan="3" \|<small>Получение архива модели.</small>
	\|-		\|-
Строка 40:		Строка 40:
	\|<small>ZIP-файл с моделью, либо <code>{ error: INT , message: DESCRIPTION }</code></small>		\|<small>ZIP-файл с моделью, либо <code>{ error: INT , message: DESCRIPTION }</code></small>
	\|-		\|-
	!style="color:green;width: 15%"\|'''POST:/spr/~~data~~/{id}'''		!style="color:green;width: 15%"\|'''POST:/spr/import/{id}'''
	! colspan="3" \|<small>Добавление модели. Может быть добавлена как из файла архива, так и переименованием существующей модели.</small>		! colspan="3" \|<small>Добавление модели. Может быть добавлена как из файла архива, так и переименованием существующей модели.</small>
	\|-		\|-
Строка 51:		Строка 51:
	\|<small><code>{ error: INT, message: DESCRIPTION }</code></small>		\|<small><code>{ error: INT, message: DESCRIPTION }</code></small>
	\|-		\|-
	!style="color:red;width: 15%"\|'''DELETE:/spr/~~data~~/{id}'''		!style="color:red;width: 15%"\|'''DELETE:/spr/delete/{id}'''
	! colspan="3" \|<small>Удаление модели.</small>		! colspan="3" \|<small>Удаление модели.</small>
	\|-		\|-