SBS. Руководство пользователя

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

Сервис Simple Biometry Server предназначен для извлечения именованных сущностей из текстовых фрагментов (фраз естественной речи). Принимает на вход текстовую строку и возвращает структурированные данные в формате JSON.

Термины и определения

Simple Biometry Server (SBS) - сервис извлечения метаданных.

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

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

Запросы осуществляются по протоколу HTTP 1.1 на адрес сервера с доступным сервисом SBS. По умолчанию используется порт 6185/tcp.

Авторизация запросов не требуется. HTTP-запросы должны содержать заголовок "accept: application/json"

Ответ сервиса представляет собой JSON-документ в кодировке UTF-8 или двоичный файл. Содержимое документа зависит от результата выполнения запроса. При наличии ошибки в качестве ответа вернется переменная error=1 и описание в переменной message. Для удобства проверки методов по ссылке http://АДРЕС:6185 будет отображен интерфейс swagger со всеми методами с возможностью их проверки. Модель может содержать постобработчик. Это стандартный файл на языке Python, который выполняет произвольные действия с результатом работы модели. Обязательным условием является наличие функции handler, которая должна возвращать данные такого же вида, как и метод GET /sbs/entities/{id}.

Пример пустой функции:

def handler(entities=[],text=""):

  returns entities

На вход подается результат работы модели, а также начальный текст.

Метод	Тип	Описание	Входные параметры	Ответ
/sbs/	GET	Вывод списка моделей	-	{ models: [model1,...,modelN] }
/sbs/analyze/{id}	POST	Получение аналитических метаданных из голосового фрагмента	id - идентификатор модели. wav - файл для анализа	Вернется массив с метаданными голосового фрагмента. Пример: { age: { class: 20-29, confidence: 0.99 }, emotion: { class: SADNESS, confidence: 0.99 }, gender: { class: FEMALE, confidence: 0.99 } } age - возраст 00-05 06-12 13-19 20-29 30-39 40-49 50-59 60+ emotion - эмоция ANGER BORE DISAPPOINTMENT DISGUST EXCITEMENT FEAR NEUTRAL PAIN PLEASURE SADNESS SUPRISE gender - пол MALE FEMALE
/sbs/embedding/{id}	POST	Получение оцифрованного представления говорящего	id - идентификатор модели. wav - файл для анализа	Пример ответа: { error: 0, embedding: [ 0.019493144005537033, -0.08348844200372696, ... ] }
/sbs/search/{id}	POST	Поиск говорящего по базе слепков	id - идентификатор модели. wav - файл для анализа	Пример ответа: { error: 0, speaker: Ivan, confidence: 0.79 }
/sbs/speaker/{id}/{speaker_id}	POST	Добавление слепка в базу.	id - идентификатор модели speaker_id - идентификатор говорящего wav - файл для создания оцифрованного представления говорящего	{ error: INT, message: DESCRIPTION }
/sbs/speaker/{id}/{speaker_id}	DELETE	Удаление слепка из базы	id - идентификатор модели speaker_id - идентификатор говорящего	{ error: INT, message: DESCRIPTION }
/sbs/speakers/{id}	GET	Получение списка всех слепков	id - идентификатор модели	[ "Kiryl", "Artem", "vladimir", "Sergey", "vladimir2", "Alla" ]
/sbs/verify/{id}/{speaker_id}	POST	Сравнение оцифрованного представления wav-файла cо слепком в базе	id - идентификатор модели speaker_id - идентификатор говорящего	{ "error": 0, "confidence": 0.78 }