Conheça a nossa nova rota Liveness Streaming!

Search Face Image [multipart/form-data]

POST

https://mostqiapi.com/process-image/biometrics/database/search-face-image

face compareface matchbanco de faces

Last modified:2024-06-18 20:25:35

Request

Header Params

Authorization

string

required

Token de autorização obtido no método user/authenticate.

Example:

Bearer {{bearer_token}}

Body Params multipart/form-data

file

required

Binário do arquivo de imagem que contenha faces.

database

string

required

Nome do banco de dados de faces

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://mostqiapi.com/process-image/biometrics/database/search-face-image' \
--header 'Authorization: Bearer ' \
--form 'file=@""' \
--form 'database=""'

Responses

🟢200OK

application/json

Body

result

array [object {2}]

required

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

faceId

string

required

ID da face mais similar encontrada

similarity

number <float>

required

Score de similaridade entre a face de maior área da imagem enviada e a face mais similar encontrada no banco de dados de faces. É normalizado no intervalo de 0.0 (menor score) à 1.0 (maior score). Quanto maior este valor maior é a similaridade.

>= 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

Example

{
  "result": [
    {
      "faceId": "f1640495-0a60-4bba-b211-4f2e4029b90a",
      "similarity": 0.67
    }
  ],
  "requestId": "Qw5SbuZ67gm4voMhsTwcA",
  "elapsedMilliseconds": 299,
  "status": {
    "message": "Ok",
    "code": "200",
    "errors": null
  }
}

🟠401R117 Invalid authorization data

🔴500E100 The request could not be processed

Modified at 2024-06-18 20:25:35

SearchFaceImage

Search Face Image [application/json]