Process Facial Recognition And Liveness From Files

The purpose of this endpoint is to perform a comparison between two images - typically a selfie and an image taken from an identity document. The endpoint verifies whether the person in both images is the same and allows performing a liveness check on the selfie image.

POST /v1/Acuface/ProcessFacialRecognitionAndLivenessFromFiles

Parameters

Name	In	Type	Required	Description
`traceId`	query	string	optional	A string provided by a programmer and echoed back unchanged in the response, designed to facilitate easier tracking of requests and responses.
`checkForSelfieLiveness`	query	boolean	optional	The purpose of this field is to allow the user to decide whether to perform a liveness check on the submitted selfie image.

Request body

Name	Type	Required	Description
`portraitImage`	string / binary	Required	The user's face image - typically extracted from an identity document.
`selfieImage`	string / binary	Required	The user's selfie image - this image will undergo a liveness check if such a check is requested.

Code sample language

curl -X POST "{{API.SANDBOX_BASE_URL}}/Acuface/ProcessFacialRecognitionAndLivenessFromFiles" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "portraitImage=@portraitImage.jpg" \
  -F "selfieImage=@selfieImage.jpg"

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");
using var content = new MultipartFormDataContent();
content.Add(new ByteArrayContent(File.ReadAllBytes("portraitImage.jpg")), "portraitImage", "portraitImage.jpg");
content.Add(new ByteArrayContent(File.ReadAllBytes("selfieImage.jpg")), "selfieImage", "selfieImage.jpg");
var response = await client.PostAsync("{{API.SANDBOX_BASE_URL}}/Acuface/ProcessFacialRecognitionAndLivenessFromFiles", content);
var result = await response.Content.ReadAsStringAsync();

import requests

headers = {"x-api-key": "YOUR_API_KEY"}
files = {"portraitImage": open("portraitImage.jpg", "rb"), "selfieImage": open("selfieImage.jpg", "rb")}
response = requests.post("{{API.SANDBOX_BASE_URL}}/Acuface/ProcessFacialRecognitionAndLivenessFromFiles", headers=headers, files=files)
print(response.json())

// Each *File below is a File or Blob holding the image.
const form = new FormData();
form.append("portraitImage", portraitImageFile);
form.append("selfieImage", selfieImageFile);
const response = await fetch("{{API.SANDBOX_BASE_URL}}/Acuface/ProcessFacialRecognitionAndLivenessFromFiles", {
  method: "POST",
  headers: { "x-api-key": "YOUR_API_KEY" },
  body: form
});
const result = await response.json();

Responses

`200`	OK