Verify whether two images match

POST /verify

Verify whether two images match

cURL

curl --request POST \
  --url https://deepface-cyybxg.fly.dev/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "img1": "<string>",
  "img2": "<string>"
}
'

200

{
  "verified": true,
  "distance": 123,
  "threshold": 123,
  "model": "<string>",
  "facial_areas": {},
  "time": 123
}

Authorizations

BearerAuthApiKeyHeader

Authorization · string · header · required

Use your API key as a bearer token.

Headers

x-request-id · string<uuid>

Optional UUID used for request tracing.

Body

application/jsonmultipart/form-data

img1 · string · required

Base64 image payload or data URL.

img2 · string · required

Base64 image payload or data URL.

model_name · string

Approved model name from the current allowlist.

Example:

"Facenet"

detector_backend · string

Optional detector backend from the current allowlist.

Example:

"opencv"

enforce_detection · boolean · default: true

align · boolean · default: true

normalization · string

Optional DeepFace normalization mode.

distance_metric · enum<string>

Available options: cosine, euclidean, euclidean_l2

Example:

"cosine"

Response

200

application/json

Verification result

verified · boolean · required

distance · number · required

threshold · number · required

model · string

facial_areas · object

Show child attributes

time · number