v1

latestOpenAPI 3.0.12026-07-24121548.0 KB
Biometria Facial 1:N

Buscar face na coleção

Descrição

A busca de face na coleção é a operação central da Biometria Facial 1:N do BigID, responsável por comparar uma imagem de rosto enviada com todas as faces previamente cadastradas em uma coleção. Utilizando modelos avançados de Inteligência Artificial, a tecnologia identifica as faces mais semelhantes e retorna os respectivos índices de similaridade e identificadores associados.

Essa funcionalidade é amplamente utilizada em fluxos de autenticação, controle de acesso, identificação de usuários e detecção de tentativas de fraude. Quando configurada para retornar múltiplos resultados, a tecnologia pode apresentar até 6 correspondências, considerando apenas faces com índice mínimo de similaridade de 70%, ordenadas da maior para a menor similaridade. Caso menos resultados atendam a esse critério, apenas as correspondências válidas são retornadas.

Para mais informações sobre casos de uso, principais dúvidas e orientações de aplicação, acesse Biometria Facial.

Tabela de preços

A cobrança é realizada conforme o volume mensal de consultas, de acordo com a tabela abaixo:

Consultas realizadas no mêsValor por consulta
1 – 10.000R$ 0,170
10.001 – 50.000R$ 0,162
50.001 – 100.000R$ 0,153
100.001 – 500.000R$ 0,146
500.001 – 1.000.000R$ 0,138
1.000.001 – 5.000.000R$ 150.000,00 (preço fixo)
Acima de 5.000.000Entre em contato
post/faces/buscar

Request body

face_imagestring required

Imagem de rosto em Base64 ou URL.

base_dbstring required

Identificador da coleção onde a busca será realizada.

PrivateUrlboolean

Indica se a URL da imagem está em diretório privado.

all_facesboolean

Define se devem ser retornadas múltiplas faces com maior similaridade (até 6 resultados acima de 70%).

Example request

{
  "face_image": "base64_ou_URL_imagem",
  "base_db": "nome_da_colecao"
}

Response

Resultado da busca de face na coleção.

Documentstring

Tipo de documento associado à face encontrada.

Document_Numberstring

Número do documento associado à face encontrada.

Similaritynumber[]

Índices de similaridade calculados entre a imagem enviada e as encontradas.

deepFakeIndicatornumber

Indicador com percentual de probabilidade de ser deepfake

velocityIndicatorboolean

Indicador de velocity

ResultCodeinteger

Código de resultado.

TicketIdstring

Identificador da operação.

Messagestring

Mensagem de resultado.

successboolean

Indica se a operação foi bem-sucedida.