Comparação biométrica 1:1
Mede a similaridade entre dois rostos com uma pontuação de 0 a 100. É a operação padrão.
"biometric": {"0": {"1": 93}}O Face Analysis compara a selfie de uma pessoa com a foto do documento dela e devolve uma pontuação de similaridade de 0 a 100. Uma chamada à API e você sabe se é a mesma pessoa.
Para gerar sua API Key, você precisa de um plano pago da VU.
Imagem "0" · selfie
"biometric": {"0": {"1": 93}}93 ≥ 70 · mesma pessoaConforme ao iBeta PAD Nível 3
ISO/IEC 30107-3 · Prova de vida
ISO/IEC 27001:2022
Gestão de segurança da informação
ISO/IEC 27017:2015
Segurança em serviços de nuvem
Um documento roubado, emprestado ou adquirido de forma irregular passa nos controles documentais porque é autêntico: os dados coincidem e o formato está correto. A pergunta que fica sem resposta é se o rosto da selfie corresponde ao titular. Quando essa comparação depende de uma pessoa que revisa duas fotografias, o processo não escala nem deixa um critério auditável.
O serviço compara os rostos enviados e devolve o nível de similaridade em uma escala de 0 a 100. A decisão não é automática: a política interna que você definir avalia a pontuação com que a identidade é confirmada. O serviço também não verifica se a selfie corresponde a uma pessoa presente; essa validação é feita pelo Antispoofing facial, que pode ser solicitado na mesma chamada.
Caso 01
Você já conta com outro fornecedor
Não é necessário migrar toda a sua operação para incorporar a comparação biométrica. Você pode consumir apenas esta API, em paralelo com seu fornecedor atual.
Caso 02
Você precisa verificar clientes recorrentes
Durante o cadastro, o vetor biométrico do rosto do seu cliente é armazenado. Em cada nova interação, a selfie é comparada com esse vetor, sem necessidade de solicitar o documento novamente.
Caso 03
Você está construindo seu próprio produto
Você precisa do componente de comparação facial, não de uma plataforma completa. Você o integra à sua solução e mantém o controle sobre o resto do processo.
Você declara, imagem por imagem, o que quer analisar. Se não declarar nenhuma operação, a comparação biométrica é executada por padrão.
Mede a similaridade entre dois rostos com uma pontuação de 0 a 100. É a operação padrão.
"biometric": {"0": {"1": 93}}O resultado do Antispoofing facial chega aninhado na mesma resposta, sem necessidade de uma segunda requisição.
{ "biometric": { … }, "spoofing": { … } }
Sinais para determinar se a captura é adequada.
Giro e inclinação, em graus.
Coordenadas de ambos os olhos.
Selfie contra documento
Você envia as duas imagens e recebe a pontuação de similaridade entre elas. A foto do documento pode vir do ID Analysis, que a entrega já recortada.
Selfie contra um vetor guardado
Você solicita o vetor biométrico do rosto, armazena-o e o usa em comparações futuras, sem necessidade de conservar a foto. Registre também a metodologia com que o gerou, já que a escala da pontuação varia conforme a metodologia.
Qualidade da captura
Se você solicitar atributos e pose na mesma chamada, a resposta inclui um veredito de qualidade: high, medium ou low. Se o resultado for low, solicite uma nova captura antes de confiar na pontuação.
Integração
Não substitui o Identity Link quando você precisa de uma verificação completa. Você pode usá-lo de forma independente ou combiná-lo com outros serviços em nuvem da VU.
Sem SDK nem dependências. Chame a API a partir do seu backend: A chave nunca fica exposta em um app móvel nem no navegador.
| Elemento | Como funciona |
|---|---|
| GET /version | Verifica a conectividade. Avalia-se o código de status, não o corpo da resposta |
| POST /inference | Executa as operações solicitadas sobre as imagens que você envia |
| Autenticação | Cabeçalho Api-Key. Cada serviço tem sua própria chave, por ambiente |
| URL base | A VU entrega junto com a chave, conforme o ambiente |
| Entrada | info como referência de negócio, images em base64 e operations, uma lista por imagem |
| Saída | id, code, message e biometric (matriz de similaridade de 0 a 100). Os demais campos dependem das operações que você solicitar |
// Cabeçalho: Api-Key: <sua chave do serviço>
{
"info": "onboarding-12345",
"images": ["<selfie em base64>", "<rosto do documento>"],
"operations": [["biometric"], ["biometric"]]
}"biometric": {"0": {"1": 93}}93 é maior ou igual a 70. É a mesma pessoa: você confirma."biometric": {"0": {"1": 19}}Abaixo do limiar. Você não confirma.if (status === 200 && body.biometric?.["0"]?.["1"] >= 70) {
mesmaPessoa();
} else {
naoConfirmada();
}Não confirme por exclusão
Não existe um código de erro que indique "não é a mesma pessoa": quando os rostos não coincidem, a resposta chega com código 200 e uma pontuação baixa. Se sua lógica aprova tudo o que não for uma rejeição explícita, qualquer resposta inesperada acabará convertida em uma aprovação.
O limiar de 70 se aplica à metodologia padrão. Se você escolher outra, a escala da pontuação muda e você precisará calibrar seu próprio limiar.
| Aspecto | Valor |
|---|---|
| Resolução recomendada | 360 × 360 ou mais* |
| Rosto | Apenas um por imagem, de frente e com os olhos visíveis |
| Formato | JPEG ou PNG. Se for JPEG, qualidade 90 ou superior |
| Codificação | base64 sem prefixo data: e sem quebras de linha |
*A resolução mínima aceita é 160 × 160. Abaixo disso, a API devolve erro.
Com um plano pago, você gera a chave no painel da VU e chama o serviço a partir do seu backend.
Você confirma o acessocom o método que o painel oferecer
Você abre Cloud Servicesno menu lateral
Você escolhe Face Analysisentre os serviços disponíveis
Você gera a API keycom um plano pago, para o ambiente que vai usar
Você copia a chave e chama GET /versionpara confirmar a conectividade
Para gerar sua API Key, você precisa de um plano pago da VU.
Gere sua chave e compare um par que você já conhece.
Para gerar sua API Key, você precisa de um plano pago da VU.