Buscar recortes
Búsqueda 1:N con recortes faciales (regiones pequeñas). min_score debe estar entre 0,5 y 1.
menu_bookReferencia API: búsqueda facial 1:N (recortes)expand_more
Documentación oficial: docs.verifik.co/biometrics/search-crops (búsqueda 1:N con recortes faciales; min_score es 0,5–1, distinto de la búsqueda estándar).
URL base https://api.verifik.co. Envía una o más entradas en images en base64 o URLs HTTPS (la API puede obtener las URLs en el servidor). Opcionalmente collection_id y max_results.
POST /v2/face-recognition/search/crops
Devuelve candidatos ordenados en data, misma forma general que /face-recognition/search.
| Cabecera | Valor |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| Parámetro | Obl. | Descripción |
|---|---|---|
| images | Sí | Recortes faciales (base64 y/o URLs HTTPS), mismo sujeto |
| min_score | Sí | 0,5–1 |
| search_mode | Sí | FAST o ACCURATE |
| collection_id | No | Limitar la búsqueda a una colección |
| max_results | No | Tope de coincidencias devueltas |
await searchCrops(
{
images: ["<base64>", "<base64>"],
min_score: 0.75,
search_mode: "FAST",
collection_id: "<optionalCollectionMongoId>",
max_results: 10,
},
accessToken,
);- Esta demo usa searchCrops de @humanauthn/api-client con tu token de sesión.
- Las respuestas suelen incluir coincidencias ordenadas y pueden incluir un bloque signature según el entorno.
Documentación relacionada
Guías oficiales en docs.verifik.co
Búsqueda facial (1:N)
Búsqueda en galería con imágenes completas; suelo de min_score más bajo (0,2–1).
Búsqueda facial 1:N (en vivo)
Prueba de vida en la imagen de consulta y luego búsqueda 1:N.
Búsqueda facial 1:N (usuario activo)
Búsqueda 1:N para sesiones activas sin vida en la consulta.
Verificar rostro (1:1)
Compara imágenes de consulta con una persona inscrita conocida.
Detección facial
Detecta rostros en una imagen para obtener recortes antes de buscar.
Listar todas las personas
Inspecciona las personas inscritas de tu cliente.