Face Compare 1:1 [multipart/form-data]

POSThttps://mostqiapi.com/process-image/biometrics/face-compare

Last modified: 4 months ago

Request

Header Params

Authorization

string

required

Token de autorização obtido no método Authentication/Authenticate

Example:

Bearer XXXXXXXXXXXXX

Body Params multipart/form-data

faceFileA

file

optional

🔸Requerido quando o parâmetro faceFileUrlA não é informado.
Binário do arquivo a ser processado.

faceFileB

file

optional

🔸Requerido quando o parâmetro faceFileUrlB não é informado.
Binário do arquivo a ser processado.

faceFileUrlA

string

optional

🔸Requerido quando o parâmetro faceFileA não é informado.
Url pública do arquivo a ser processado.

faceFileUrlB

string

optional

🔸Requerido quando o parâmetro faceFileB não é informado.
Url pública do arquivo a ser processado.

faceFilePasswordA

string <base64>

optional

🔸Requerido caso o arquivo enviado no parâmetro faceFileA ou faceFileUrlA seja um PDF criptografado por senha.
A senha deve ser codificada em uma string base64, pois PDFs permitem que as senhas sejam dados binários.

faceFilePasswordB

string <base64>

optional

🔸Requerido caso o arquivo enviado no parâmetro faceFileB ou faceFileUrlB seja um PDF criptografado por senha.
A senha deve ser codificada em uma string base64, pois PDFs permitem que as senhas sejam dados binários.

Request samples

Responses

OK(200)

HTTP Code: 200

Content Type : JSONapplication/json

result

object

required

Lista contendo o resultado do método (consulte na documentação específica de cada um).

distances

array[number <float>]

float

deprecated

Lista contendo a medida de distância entre as duas faces enviadas. Quanto menor este valor maior é a similaridade. (Legado)

similarity

number <float>

required

Campo com o score de similaridade entre as faces comparadas. É normalizado no intervalo de 0.0 (menor score) à 1.0 (maior score). Quanto maior o score, maior a similaridade entre as faces.

>= 0<= 1

requestId

string

required

Código único de identificação da solicitação ao servidor, que será registrado no histórico de consumo dos serviços.

elapsedMilliseconds

integer

required

Tempo de duração do processamento em milissegundos.

status

object

required

Objeto contendo o código de status e a mensagem de resposta.

message

string | null

required

Mensagem de retorno de status. Veja os valores possíveis nas mensagens de erro do mostQI.

code

string

required

Código de status interno. Veja os valores possíveis nas mensagens de erro do mostQI.

errors

array [object {2}] | null

required

Lista de objetos do tipo Error, o formato é variável.

{
  "result": {
    "distances": [
      0.81
    ],
    "similarity": 0.19
  },
  "requestId": "eyDwui1750WVJTkno8VZD",
  "elapsedMilliseconds": 493,
  "status": {
    "message": "Ok",
    "code": "200",
    "errors": null
  }
}

Last modified: 4 months ago