1:1 Match API

Mencocokkan Dua Foto Wajah (1:1)

Membandingkan dua gambar wajah dan menentukan apakah keduanya merupakan orang yang sama. Mengembalikan nilai similarity beserta flag boolean match berdasarkan threshold internal FREMIS-N. Gunakan untuk skenario verifikasi — di mana identitas sudah diketahui dan perlu dikonfirmasi. Untuk input yang lebih fleksibel (embedding atau face_id), gunakan versi v2.

curl -X POST "https://fremis-n.example.com/v1/face/match" \  -H "Content-Type: application/json" \  -d '{    "image_a": {      "content": "<base64-encoded-image>"    },    "image_b": {      "content": "<base64-encoded-image>"    }  }'

{  "face_match": {    "match": true,    "similarity": 0.91  }}

{  "code": "400",  "message": "invalid arguments"}

{  "code": "401",  "message": "Inactive analytic"}

"Analytic NFFS-FR is not available in deployment key"

"Too many requests"

{  "code": "500",  "message": "internal server error"}

"License has not been initialized"

Mencocokkan Dua Foto Wajah (1:1, versi 2)

Versi yang lebih fleksibel dari endpoint pencocokan 1:1. Setiap wajah (face_a dan face_b) dapat diberikan dalam tiga bentuk: gambar base64, vektor embedding, atau face_id yang sudah terdaftar di keyspace. Berbeda dari v1, endpoint ini hanya mengembalikan nilai similarity tanpa flag match — keputusan threshold diserahkan ke aplikasi pemanggil. Gunakan ketika salah satu sisi sudah memiliki embedding tersimpan untuk menghindari komputasi ulang.

curl -X POST "https://fremis-n.example.com/v2/face/match" \  -H "Content-Type: application/json" \  -d '{    "face_a": {      "image": "<base64-encoded-image>"    },    "face_b": {      "face_id": "budi-001",      "keyspace": "karyawan-jakarta"    }  }'

{  "similarity": 0.88}

{  "code": "400",  "message": "invalid arguments"}

{  "code": "401",  "message": "Inactive analytic"}

"Analytic NFFS-FR is not available in deployment key"

"Too many requests"

{  "code": "500",  "message": "internal server error"}

"License has not been initialized"