Buscar recortes
Busca 1:N usando recortes faciais (regiões pequenas). min_score deve estar entre 0,5 e 1.
menu_bookReferência da API: Face Search 1:N (Crops)expand_more
Documentação oficial: docs.verifik.co/biometrics/search-crops (busca 1:N por recortes faciais; min_score é 0,5–1, diferente do Face Search padrão).
URL base https://api.verifik.co. Envie uma ou mais entradas em images como base64 cru ou URLs HTTPS (a API pode buscar URLs no servidor). Opcionalmente collection_id e max_results.
POST /v2/face-recognition/search/crops
Retorna candidatos ordenados em data, formato geral semelhante a /face-recognition/search.
| Cabeçalho | Valor |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| Param | Obrig. | Descrição |
|---|---|---|
| images | Sim | Recortes faciais (base64 e/ou URLs HTTPS), mesma pessoa |
| min_score | Sim | 0,5–1 |
| search_mode | Sim | FAST ou ACCURATE |
| collection_id | Não | Limitar a busca a uma coleção |
| max_results | Não | Teto de correspondências retornadas |
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 com o token da sua sessão.
- As respostas costumam incluir correspondências ordenadas e podem incluir assinatura conforme o ambiente.
Documentação relacionada
Guias oficiais em docs.verifik.co
Face Search (1:N)
Busca em galeria com imagens faciais completas; piso de min_score menor (0,2–1).
Face Search 1:N (Live)
Vivacidade na imagem de prova e depois busca 1:N.
Face Search 1:N (Active User)
Busca 1:N para fluxos de sessão ativa sem vivacidade na prova.
Verify Face (1:1)
Comparar imagens de prova com uma pessoa cadastrada conhecida.
Face Detection
Detectar faces em uma imagem para obter recortes antes de buscar.
Listar todas as pessoas
Inspecionar pessoas cadastradas do seu cliente.