Векторы - NeuroVision

POST /vector/search

Описание

Метод сравнивает биометрические (фото-)векторы с векторами персон из указанных списков. Для доступа нужен токен, см. раздел «Авторизация».

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

HTTP метод: POST
URL: /vector/search
Тип контента: application/json

Авторизация

Токен передаётся одним из способов:

заголовок token: <jwt-token> — временный JWT-токен, полученный методом user/login;
поле token в теле запроса — постоянный API-токен (UUID) из личного кабинета.

Без токена запрос вернёт 401 access denied.

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

Поле	Тип	Обязательный	Описание
token	string	—	Постоянный API-токен (UUID), если нет заголовка `token`
embeddings	string	✅	Биометрический вектор (или строка векторов)
list_ids	string	✅	Идентификатор(ы) списков персон для поиска
threshold	string	❌	Порог совпадения
person_data	boolean	❌	Возвращать ли данные найденных персон
results	string	❌	Формат результата (например, «all», «top»)

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

curl -X POST "https://api.neuro-vision.ru/v1/vector/search" -H "Content-Type: application/json" -H "token: <jwt-token>" -d '{"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"
}