Serviços em nuvem da VU

Um documento real não garante seu dono real

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.

Selfie de uma pessoaImagem "0" · selfie
Documento de identidade"1"
0
"biometric": {"0": {"1": 93}}93 ≥ 70 · mesma pessoa

Segurança respaldada por certificações e testes independentes

Conforme 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

O problema

Ter um documento válido não prova quem o está apresentando

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.

Nossa solução

Uma pontuação para cada par de rostos. Você define o limiar.

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.

Características principais

Uma chamada, as operações que você escolher

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.

01

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.

0limiar 70
0100
"biometric": {"0": {"1": 93}}
02

Antispoofing na mesma chamada

O resultado do Antispoofing facial chega aninhado na mesma resposta, sem necessidade de uma segunda requisição.

{
  "biometric": { … },
  "spoofing": { … }
}
03

Atributos faciais

Sinais para determinar se a captura é adequada.

  • nitidez
  • óculos
  • olhos fechados
  • máscara
04

Pose da cabeça

Giro e inclinação, em graus.

05

Posição das íris

Coordenadas de ambos os olhos.

Compare com o documento ou com um rosto que você já guardou

  • 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.

A integração

Dois endpoints e uma regra de decisão.

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.

ElementoComo funciona
GET /versionVerifica a conectividade. Avalia-se o código de status, não o corpo da resposta
POST /inferenceExecuta as operações solicitadas sobre as imagens que você envia
AutenticaçãoCabeçalho Api-Key. Cada serviço tem sua própria chave, por ambiente
URL baseA VU entrega junto com a chave, conforme o ambiente
Entradainfo como referência de negócio, images em base64 e operations, uma lista por imagem
Saídaid, code, message e biometric (matriz de similaridade de 0 a 100). Os demais campos dependem das operações que você solicitar
RequisiçãoPOST /inference
// 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.
A regra de decisãoSeu backend
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.

Requisitos da imagem

A qualidade da captura decide quanto vale a pontuação.

AspectoValor
Resolução recomendada360 × 360 ou mais*
RostoApenas um por imagem, de frente e com os olhos visíveis
FormatoJPEG ou PNG. Se for JPEG, qualidade 90 ou superior
Codificaçãobase64 sem prefixo data: e sem quebras de linha

*A resolução mínima aceita é 160 × 160. Abaixo disso, a API devolve erro.

Envie 360 × 360 mesmo que o mínimo seja mais baixoAbaixo de 360 px a API responde igual, com código 200, mas o veredito de qualidade cai para low. A compressão agressiva também degrada a pontuação. A qualidade da captura é uma decisão de integração: defina-a no começo.
Como começar

Autogerenciável, conecte esta API sem intermediários

Com um plano pago, você gera a chave no painel da VU e chama o serviço a partir do seu backend.

  1. 02

    Você confirma o acessocom o método que o painel oferecer

  2. 03

    Você abre Cloud Servicesno menu lateral

  3. 04

    Você escolhe Face Analysisentre os serviços disponíveis

  4. 05

    Você gera a API keycom um plano pago, para o ambiente que vai usar

  5. 06

    Você copia a chave e chama GET /versionpara confirmar a conectividade

Gere sua API Key

Para gerar sua API Key, você precisa de um plano pago da VU.

Perguntas frequentes

Não. Você pode consumi-la de forma independente, com sua própria chave, sobre o fluxo que escolher. Convive com o fornecedor que você já tem instalado.
Sim. Você pode solicitar o vetor biométrico do rosto, armazená-lo e usá-lo em comparações futuras, sem precisar guardar a foto. Registre também a metodologia com que o gerou, já que a escala da pontuação varia conforme a metodologia.
70 é o limiar de referência para a metodologia padrão. Ainda assim, o serviço não toma a decisão por você: sua política define a partir de qual pontuação você confirma a identidade. Se usar outra metodologia, a escala da pontuação muda e você precisará calibrar seu próprio limiar.
Não por si só. A comparação biométrica mede o quanto dois rostos se parecem, mas não verifica se a selfie corresponde a uma pessoa presente. Para isso existe o Antispoofing facial, que você pode solicitar na mesma chamada; o resultado chega aninhado na resposta, sem necessidade de uma segunda requisição.
No cabeçalho Api-Key de cada requisição. Cada serviço tem sua própria chave para cada ambiente, e a VU a fornece junto com a URL base correspondente.
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.

Você já tem a selfie e o documento. Falta a pontuação.

Gere sua chave e compare um par que você já conhece.

Gere sua API Key

Para gerar sua API Key, você precisa de um plano pago da VU.