POST /vector/search
Описание
Метод сравнивает биометрические (фото-)векторы с векторами персон из указанных списков. Для доступа необходим JWT-токен в заголовке.
Формат запроса
- HTTP метод:
POST - URL:
/vector/search - Тип контента:
application/json - Авторизация: требуется
Параметры запроса
| Параметр | Тип | Где передаётся | Обязательный | Описание |
|---|---|---|---|---|
| token | string | Header | ✅ | JWT-токен пользователя |
Тело запроса (JSON)
| Поле | Тип | Обязательный | Описание |
|---|---|---|---|
| token | string | ✅ | JWT-токен пользователя |
| 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 "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"
}