Векторы

POST /vector/search


Описание

Метод сравнивает биометрические (фото-)векторы с векторами персон из указанных списков. Для доступа необходим JWT-токен в заголовке.


Формат запроса

  • HTTP метод: POST
  • URL: /vector/search
  • Тип контента: application/json
  • Авторизация: требуется

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

ПараметрТипГде передаётсяОбязательныйОписание
tokenstringHeaderJWT-токен пользователя

Тело запроса (JSON)

ПолеТипОбязательныйОписание
tokenstringJWT-токен пользователя
embeddingsstringБиометрический вектор (или строка векторов)
list_idsstringИдентификатор(ы) списков персон для поиска
thresholdstringПорог совпадения
person_databooleanВозвращать ли данные найденных персон
resultsstringФормат результата (например, «all», «top»)

Пример запроса (cURL)

curl -X POST "https://api.neuro-vision.ru/v1/vector/search" 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer jwt.temporary.token" 
  -d '{
    "token": "jwt.temporary.token",
    "embeddings": "0.123,0.456,0.789",
    "list_ids": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "threshold": "0.7",
    "person_data": true,
    "results": "top"
  }'

Примеры ответов

Успех (200 OK)
{
  "results": [
    {
      "additionalProp1": {}
    }
  ],
  "status": "ok"
}
Ошибка (400 Invalid input)
{
  "message": "invalid input",
  "status": "error"
}