API Reference — Face Search

Pencarian Kandidat Wajah

Endpoint utama untuk mencari wajah yang mirip dengan foto referensi. Mengembalikan daftar face_id kandidat beserta skor similarity dari database Fremis N.

Alur integrasi:

1. Encode foto referensi ke format base64
2. Kirim ke POST /api/fremisn/v1/face/recognition dengan x-search-method yang sesuai
3. Gunakan face_id dari hasil untuk lookup data identitas ke GET /api/enrolled-faces/get-by-face-ids

curl -X POST "https://lenz.example.com/api/fremisn/v1/face/recognition" \  -H "x-search-method: face-search-candidates" \  -H "Content-Type: application/json" \  -d '{    "image": "/9j/4AAQSkZJRgABAQAAAQABAAD...",    "keyspace": "default",    "additional_params": {      "candidateCount": 5    }  }'

{  "result": {    "face_recognition": {      "candidates": [        {          "face_id": "abc123def456",          "similarity": 0.92,          "variation": "9876543210"        },        {          "face_id": "xyz789uvw012",          "similarity": 0.78,          "variation": "1234567890"        }      ]    }  }}

{  "ok": false,  "message": "invalid image format"}

{  "ok": false,  "message": "unauthorized"}

{  "ok": false,  "message": "internal server error"}

Perbandingan Dua Wajah (Face Match)

Endpoint untuk membandingkan dua wajah secara langsung dan mendapatkan skor kemiripan. Mendukung dua mode:

• Gambar vs Gambar — bandingkan dua foto base64 tanpa referensi ke database (x-search-method: face-match-image)
• Terdaftar vs Gambar — bandingkan face_id enrollment yang sudah ada dengan foto baru (x-search-method: face-match-faceid)

curl -X POST "https://lenz.example.com/api/fremisn/v2/face/match" \  -H "x-search-method: face-match-image" \  -H "Content-Type: application/json" \  -d '{    "face_a": {      "image": "/9j/4AAQSkZJRgABAQAAAQABAAD...",      "keyspace": "default"    },    "face_b": {      "image": "/9j/4AAQSkZJRgABAQAAAQABAAD..."    }  }'

{  "similarity": 0.87}

{  "ok": false,  "message": "invalid image format"}

{  "ok": false,  "message": "unauthorized"}

{  "ok": false,  "message": "internal server error"}

Keyspace

Endpoint untuk mengambil daftar keyspace yang tersedia di mesin Fremis N. Digunakan oleh UI Lenz untuk mengisi dropdown pemilihan keyspace pada form pencarian. Keyspace anonymous adalah keyspace khusus untuk data wajah anonim.

curl -X GET "https://lenz.example.com/api/fremisn/v1/get-all-keyspaces"

{  "keyspaces": [    {      "name": "default"    },    {      "name": "vip"    },    {      "name": "anonymous"    }  ]}

{  "ok": false,  "message": "unauthorized"}

{  "ok": false,  "message": "internal server error"}