SBS. Руководство пользователя: различия между версиями
Материал из Флора AI
| Строка 59: | Строка 59: | ||
| colspan="2" style="width: 50%" | | | colspan="2" style="width: 50%" | | ||
* <small>'''wav''' - файл для поиска</small> | * <small>'''wav''' - файл для поиска</small> | ||
* <small>''' | * <small>'''id''' - идентификатор говорящего</small> | ||
* <small>'''text''' - текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, но слепок не будет проверен, если распознанный текст будет сильно отличаться от '''text.'''</small> | * <small>'''text''' - текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, но слепок не будет проверен, если распознанный текст будет сильно отличаться от '''text.'''</small> | ||
| colspan="2" style="width: 50%" |<code><small>{ "error": 0, "confidence": 0.78 }</small></code> | | colspan="2" style="width: 50%" |<code><small>{ "error": 0, "confidence": 0.78 }</small></code> | ||
| Строка 107: | Строка 107: | ||
* <small>'''id''' - идентификатор слепка</small> | * <small>'''id''' - идентификатор слепка</small> | ||
* <small>'''text''' - текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, | * <small>'''text''' - текст для сравнения с распознанным текстом из '''wav''', необязательный параметр. Если указан, то слепок не будет дообучен, если распознанный текст будет сильно отличаться от '''text.'''</small> | ||
| colspan="2" style="width: 50%" |<small><code>{</code></small> | | colspan="2" style="width: 50%" |<small><code>{</code></small> | ||
<small><code> "error": 0,</code></small> | <small><code> "error": 0,</code></small> | ||
Версия от 09:26, 22 ноября 2024
Общее описание
Сервис Simple Biometry Server предназначен для извлечения именованных сущностей из текстовых фрагментов (фраз естественной речи). Принимает на вход текстовую строку и возвращает структурированные данные в формате JSON.
Термины и определения
Simple Biometry Server (SBS) - сервис извлечения метаданных.
Swagger UI – интерактивная веб-консоль с кратким описанием методов АPI и возможностью выполнять запросы к сервису SBS.
Описание методов API сервиса биометрии (SBS)
Запросы осуществляются по протоколу HTTP 1.1 на адрес сервера с доступным сервисом SBS. По умолчанию используется порт 6185/tcp.
Авторизация запросов не требуется. HTTP-запросы должны содержать заголовок "accept: application/json"
Ответ сервиса представляет собой JSON-документ в кодировке UTF-8 или двоичный файл. Содержимое документа зависит от результата выполнения запроса. При наличии ошибки в качестве ответа вернется переменная error=1 и описание в переменной message. Для удобства проверки методов по ссылке http://АДРЕС:6185 будет отображен интерфейс swagger со всеми методами с возможностью их проверки.
| POST/sbs/analyze | Получение аналитических метаданных из голосового фрагмента. Вернется массив с метаданными голосового фрагмента. | ||
|---|---|---|---|
|
Пример:
age: {
class: 20-29, # {"00-05", "06-12", "13-19", "20-29", "30-39", "40-49", "50-59", "60+"}
confidence: 0.99
},
emotion: {
class: SADNESS, # { "ANGER", "BORE", "DISAPPOINTMENT", "DISGUST", "EXCITEMENT", "FEAR", "NEUTRAL", "PAIN", "PLEASURE", "SADNESS", "SUPRISE"}
confidence: 0.99
},
gender: {
class: FEMALE, # { "MALE", "FEMALE" }
confidence: 0.99
}
| ||
| POST/sbs/search | Поиск говорящего по базе слепков. | ||
|
Пример ответа:
| ||
| POST/sbs/verify/{id} | Сравнение wav-файла cо слепком в базе. В ответе - вероятность совпадения от 0 до 1. | ||
|
{ "error": 0, "confidence": 0.78 }
| ||
| POST/sbs/speakers/add{id} | Добавление слепка в базу. | ||
|
{
| ||
| DELETE/sbs/speakers/delete/{id} | Удаление слепка из базы. | ||
|
{ error: INT, message: DESCRIPTION }
| ||
| GET/sbs/speakers/list | Получение списка всех слепков. | ||
| Входные параметры отсутствуют | [
| ||
| POST/sbs/speakers/modify/{id} | Дообучение слепка. | ||
|
{
| ||