Detectar face
Localize faces em uma imagem com caixas delimitadoras e pontuações (pipeline Verifik).
menu_bookReferência da API: Face Detectionexpand_more
Documentação oficial: docs.verifik.co/verifik-biometrics-apis/liveness/face-detection (visão geral da detecção facial, exemplos de payload e formato da resposta).
Esta demo chama POST /v2/face-recognition/detect com min_score e search_mode conforme a validação atual da API. collection_id e max_results são suportados pelo cliente, mas não aparecem no formulário abaixo.
POST /v2/face-recognition/detect
Retorna faces detectadas com geometria e pontuações. O guia publicado também documenta flags opcionais como return_landmarks quando suportado.
| Cabeçalho | Valor |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| Param | Obrig. | Descrição |
|---|---|---|
| image | Sim | Imagem de prova em base64 (base64 cru ou data URI conforme a API) |
| min_score | Sim | Limiar, tipicamente 0,5–1 |
| search_mode | Sim | FAST ou ACCURATE |
| collection_id | Não | Escopo opcional (não usado nesta UI de demo) |
| max_results | Não | Teto opcional (não usado nesta 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 com o token da sua sessão.
- Para identificação 1:N após a captura, use Face Search ou Search Live Face na documentação relacionada.
Documentação relacionada
Guias oficiais em docs.verifik.co
Face Search (1:N)
Busca por imagem facial em pessoas cadastradas.
Face Search 1:N (Live)
Vivacidade na imagem de prova e depois busca 1:N.
Face Search 1:N (Active User)
Busca 1:N sem vivacidade para fluxos de sessão ativa.
Liveness Detection
Verificar se uma face está viva ou é spoof; pontuação de vivacidade.
Face Comparison
Comparação 1:1 para verificar identidade contra imagem de referência.
Compare with Liveness
Comparação 1:1 mais detecção de vivacidade com limiares configuráveis.