Comparação de Rostos

Analise a possibilidade de dois rostos pertencerem à mesma pessoa. Usando nossa tecnologia de correspondência facial, você obterá nosso julgamento sobre se é a mesma pessoa, bem como uma pontuação de similaridade.

Exemplo de código:

curl --location --request POST 'https://api.ekycpro.com/v1/facecompare' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'X-API-Key: AbcdEfgh' \
--data-urlencode 'img1=BASE64_ENCODE_VALUE' \
--data-urlencode 'img2=BASE64_ENCODE_VALUE'

Exemplo de resposta para a mesma pessoa

{
  "status": "OK",
  "message": {
    "similarity": 97.501,
    "result": "SAME PERSON"
  }
}

Exemplo de resposta para não a mesma pessoa

{
  "status": "OK",
  "message": {
    "similarity": 27.501,
    "result": "NOT SAME PERSON"
  }
}

Exemplo de resposta para não ter certeza

{
  "status": "OK",
  "message": {
    "similarity": 50.501,
    "result": "NOT SURE"
  }
}

Exemplo de resposta para solicitação com erro

{
  "status": "INVALID_REQUEST",
  "message": "error message"
}

Exemplo de resposta para imagem carregada maior que 2M

{
  "status": "IMAGE_INVALID_SIZE",
  "message": "image larger than 2M"
}

Exemplo de resposta para não detectar rosto

{
  "status": "RETRY_LATER",
  "message": "image detect face fail"
}

Resposta para erro do servidor

{
  "status": "INNER_ERROR",
  "message": "Inner error, please retry later"
}

Solicitação HTTP

POST https://api.ekycpro.com/v1/facecompare

Parâmetros da solicitação

parâmetro	descrição
img1	string, primeira imagem em formato codificado base64
img2	string, segunda imagem em formato codificado base64

Formato da resposta

campos	descrição
status	código de status
message	similarity: pontuação de similaridade, 0~100 result: julgamento

Código de status

status	descrição
OK	charge, sucesso, message.similarity contém a pontuação de similaridade
RETRY_LATER	charge, falha na detecção de rosto na imagem
INVALID_REQUEST	free, parâmetros de solicitação inválidos
IMAGE_INVALID_SIZE	free, tamanho da imagem maior que 2M
INNER_ERROR	free, erro do servidor

Descrição do julgamento

As pontuações abaixo são valores de referência. Para melhorar a taxa de aceitação de imagens borradas no uso real, recomenda-se ajustar as pontuações adequadamente.

Resultado do Julgamento	Descrição
SAME PERSON	Pontuação >= 65 e <= 100, indicando que as duas imagens pertencem à mesma pessoa.
NOT SURE	Pontuação >= 45 e < 65, indicando que o julgamento não pode ser feito com certeza.
NOT SAME PERSON	Pontuação >= 0 e < 45, indicando que as duas imagens pertencem a pessoas diferentes.