Biometric Portrait Consistency
Compare the primary and secondary portraits printed on one identity document.
Live Engine
Engine
src/lib/verification/biometric-server/face (SCRFD + ArcFace, ONNX Runtime Node)
API
POST /api/v1/biometrics/verify
Biometric Portrait Consistency compares the portraits printed on a single identity document — the primary photo, the secondary/ghost image, or the chip portrait — and reports whether they belong to the same person. Detection uses SCRFD, embeddings use ArcFace (MobileFaceNet), and the comparison is a calibrated cosine similarity.
DocumentationCompare portraits (1:1)
POST /api/v1/biometrics/verify · two document portraits · real SCRFD + ArcFace inference
Upload Reference portrait
Upload Secondary portrait
Endpoint
POST /api/v1/biometrics/verify
modality—"face"referenceImage— base64 JPG/PNG/WEBP (primary portrait)probeImage— base64 JPG/PNG/WEBP (secondary portrait)- Auth:
Authorization: Bearer vxd_test_… | vxd_live_…
Error codes
- 400 invalid_request — Malformed JSON body or missing modality.
- 401 unauthorized — Missing, malformed, or unknown API key.
- 413 payload_too_large — One of the portraits exceeds the size limit.
- 422 validation_failed — Image could not be decoded, or no face was detected.
- 429 rate_limited — Monthly/burst quota exceeded for this key.
- 502 upstream_unavailable — Inference service unavailable — retry with backoff.
Request example
POST /api/v1/biometrics/verify
Authorization: Bearer vxd_test_...
Content-Type: application/json
{
"modality": "face",
"referenceImage": "<base64 portrait #1>",
"probeImage": "<base64 portrait #2>"
}Response example
{
"ok": true,
"result": {
"match": true,
"decision": "match",
"score": 0.9134,
"threshold": 0.28,
"engine": "veridexa-face",
"engineVersion": "arcface-mobilefacenet",
"latencyMs": 412
}
}