Detectar rostro
Localiza rostros en una imagen con cajas y puntuaciones (pipeline Verifik).
menu_bookReferencia API: detección facialexpand_more
Documentación oficial: docs.verifik.co/verifik-biometrics-apis/liveness/face-detection (visión general, cargas de ejemplo y forma de respuesta).
Esta demo llama a POST /v2/face-recognition/detect con min_score y search_mode según la validación actual de la API. collection_id y max_results son opcionales en el cliente pero no aparecen en el formulario.
POST /v2/face-recognition/detect
Devuelve rostros detectados con geometría y puntuaciones. La guía pública también documenta flags opcionales como return_landmarks cuando aplique.
| Cabecera | Valor |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| Parámetro | Obl. | Descripción |
|---|---|---|
| image | Sí | Imagen de consulta en base64 (base64 crudo o data URI según la API) |
| min_score | Sí | Umbral, habitualmente 0,5–1 |
| search_mode | Sí | FAST o ACCURATE |
| collection_id | No | Ámbito opcional (no usado en esta UI de demo) |
| max_results | No | Tope opcional (no usado en esta UI de demo) |
await fetch("https://api.verifik.co/v2/face-recognition/detect", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${accessToken}`,
},
body: JSON.stringify({
image: "<base64>",
min_score: 0.75,
search_mode: "FAST",
}),
});- Esta demo usa detectFace de @humanauthn/api-client con tu token de sesión.
- Para identificación 1:N tras capturar, usa búsqueda facial o búsqueda en vivo en la documentación relacionada.
Documentación relacionada
Guías oficiales en docs.verifik.co
Búsqueda facial (1:N)
Busca por imagen frente a personas inscritas.
Búsqueda facial 1:N (en vivo)
Prueba de vida en la consulta y luego búsqueda 1:N.
Búsqueda facial 1:N (usuario activo)
Búsqueda 1:N sin vida para flujos de sesión activa.
Detección de vida
Determina si un rostro es real o spoof; puntuación de vida.
Comparación facial
Comparación 1:1 frente a una imagen de referencia.
Comparar con vida
Comparación 1:1 más detección de vida con umbrales configurables.