Buscar persona en vivo

Prueba de vida en una imagen de consulta y luego búsqueda 1:N (en vivo).

menu_bookReferencia API: búsqueda facial 1:N (en vivo)expand_more

Documentación oficial: docs.verifik.co/biometrics/search-live-face (prueba de vida en la imagen de consulta y luego búsqueda 1:N).

URL base https://api.verifik.co. Envía una sola imagen en base64 en image (sin prefijo data URL), os obligatorio (ANDROID, IOS o DESKTOP), umbrales de vida y de coincidencia, y search_mode. Esta demo usa DESKTOP.

POST /v2/face-recognition/search-live-face

Primero anti-spoofing / vida; si pasa, ejecuta búsqueda por similitud frente a rostros inscritos.

Cabecera	Valor
Content-Type	application/json
Authorization	Bearer <token>

Parámetro	Obl.	Descripción
image	Sí	Una sola imagen de consulta en base64
os	Sí	ANDROID, IOS o DESKTOP
liveness_min_score	Sí	Umbral de vida (0,5–1,0)
min_score	Sí	Umbral de coincidencia (0,5–1,0 según documentación)
search_mode	Sí	FAST o ACCURATE
collection_id	No	Limitar la búsqueda a una colección

await fetch("https://api.verifik.co/v2/face-recognition/search-live-face", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    image: "<base64>",
    os: "DESKTOP",
    liveness_min_score: 0.65,
    min_score: 0.75,
    search_mode: "FAST",
    collection_id: "<optionalCollectionMongoId>",
  }),
});

Esta demo usa searchLivePerson de @humanauthn/api-client con tu token de sesión.
Los fallos por debajo del umbral de vida pueden devolver error (consulta formas de error en la API).

menu_book

Guías oficiales en docs.verifik.co

Object

El objeto Person

Campos y estructura de un registro de persona en reconocimiento facial.

GET

Listar todas las personas

Personas de tu cliente, con filtros opcionales.

GET

Obtener una persona

Una persona por id.

PUT