POST/api/v1/face/verify

4-Model Face Verification API

Compare any two face images with enterprise-grade precision. Our verification engine fuses ArcFace, Facenet512, buffalo_l, and buffalo_sc for majority-vote decisions.

POST /api/v1/face/verify

REQUEST

curl -X POST https://api.faceguard.io/api/v1/face/verify \
  -H "X-API-Key: fg_live_your_key_here" \
  -F "file1=@person_a.jpg" \
  -F "file2=@person_b.jpg"
200 OK
{
  "verified": true,
  "confidence": 0.91,
  "models": {
    "ArcFace":    { "verified": true,  "distance": 0.28 },
    "Facenet512": { "verified": true,  "distance": 0.35 },
    "buffalo_l":  { "verified": true,  "distance": 0.31 },
    "buffalo_sc": { "verified": false, "distance": 0.42 }
  }
}

Key Features

Everything you need from a production-ready Face Verification API.

4-Model Voting

ArcFace, Facenet512, InsightFace buffalo_l, and buffalo_sc all vote independently.

Distance Scoring

Returns cosine distance per model alongside the final verified/not-verified verdict.

Threshold Control

Each model has a calibrated threshold. Override per-request for your use case.

Fast & Scalable

All four models run in parallel. Average response under 1.5 seconds.

How it works

Integrate in minutes with our developer-friendly REST API.

01

Upload two images

POST file1 and file2 — the two face images you want to compare.

02

Parallel analysis

All four models compute embeddings and cosine distances simultaneously.

03

Majority verdict

If 3 or more models agree the faces match, the result is verified.

Data Output

Fields You Can Extract

All data returned as structured JSON — map directly to your database schema.

verified
confidence
models.ArcFace
models.Facenet512
models.buffalo_l
models.buffalo_sc
response.json
{
  "verified": true,
  "confidence": 0.91,
  "models": {
    "ArcFace":    { "verified": true,  "distance": 0.28 },
    "Facenet512": { "verified": true,  "distance": 0.35 },
    "buffalo_l":  { "verified": true,  "distance": 0.31 },
    "buffalo_sc": { "verified": false, "distance": 0.42 }
  }
}

Ready to integrate Face Verification?

Create a free account. Get 50 test API requests instantly — no credit card required.