Verificar rostro
Verificación 1:1 frente a una persona inscrita por ID.
menu_bookReferencia API: verificar rostro (1:1)expand_more
Documentación oficial (EN): docs.verifik.co/biometrics/verify-face. Español: docs.verifik.co/verifik-es/verificar-cara.
URL base https://api.verifik.co. Envía el id MongoDB de la persona inscrita en id y una o más imágenes faciales en base64 en images (sin prefijo data URL). collection_id opcional acota la comprobación.
POST /v2/face-recognition/verify
1:1 frente a una persona inscrita conocida: devuelve data.match con puntuación si se cumple el umbral.
| Cabecera | Valor |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| Parámetro | Obl. | Descripción |
|---|---|---|
| id | Sí | Id MongoDB de la persona inscrita |
| images | Sí | Array de imágenes faciales en base64 (mismo sujeto) |
| min_score | Sí | Umbral de coincidencia (0,5–1) |
| search_mode | Sí | FAST o ACCURATE |
| collection_id | No | Ámbito de colección opcional |
await verifyFace(
{
id: "<personMongoId>",
images: ["<base64>", "<base64>"],
min_score: 0.75,
search_mode: "FAST",
collection_id: "<optionalCollectionMongoId>",
},
accessToken,
);- Esta demo usa verifyFace de @humanauthn/api-client con tu token de sesión.
- Las respuestas incluyen data.match y un bloque signature cuando está habilitado.
Documentación relacionada
Guías oficiales en docs.verifik.co
Comparación facial
Comparación 1:1 entre dos conjuntos de imágenes sin id de persona inscrita.
Comparación facial (en vivo)
Comparación 1:1 con prueba de vida en la imagen de consulta.
Comparar con vida
Comparación 1:1 más umbrales de vida configurables.
Búsqueda facial (1:N)
Busca por imagen frente a personas inscritas en tus colecciones.
Detección de vida
Determina si un rostro es real o spoof; puntuación de vida.