Dokumentasi / SDK Pengenalan Wajah Dan Liveness / Verifikasi Dan Identifikasi Wajah
Verifikasi Dan Identifikasi Wajah
Bandingkan dua foto, periksa foto terhadap orang yang terdaftar, atau temukan siapa yang ada di foto di antara semua orang terdaftar, lalu baca keputusannya.
Membandingkan Dua Foto (1:1)
Misalnya foto kartu identitas dengan swafoto. Setiap foto harus menampilkan satu wajah.
curl -X POST http://localhost:8080/v2/verify -H "x-api-key: $API_KEY" \
-F image1=@id-card.jpg -F image2=@selfie.jpg -F select=largest
select=largest menerima wajah kedua yang jauh lebih kecil, seperti potret kedua berukuran kecil yang tercetak di banyak kartu identitas. Tanpa parameter itu, foto dengan dua wajah ditolak dengan MULTIPLE_FACES.
Memeriksa Foto Terhadap Orang Yang Terdaftar (1:1)
curl -X POST http://localhost:8080/v2/verify/identity -H "x-api-key: $API_KEY" \
-F uid=emp-1042 -F image=@at-the-gate.jpg
Kedua panggilan memerlukan izin verify dan menjawab dengan sebuah keputusan:
decision |
Arti |
|---|---|
match |
Orang yang sama: nilai kemiripan mencapai ambang |
no_match |
Orang yang berbeda |
inconclusive |
Sebuah wajah tidak dapat dibandingkan dengan baik (terlalu kecil, menoleh, gelap dan sebagainya); reasons wajah itu menjelaskan sebabnya |
Setiap match dan no_match membawa similarity dan threshold yang menentukannya, serta operating_point (berapa banyak penerimaan palsu yang diizinkan ambang itu, misalnya 1 dari 10,000).
Menemukan Siapa Yang Ada Di Foto (1:N)
curl -X POST http://localhost:8080/v2/identify -H "x-api-key: $API_KEY" -F image=@lobby.jpg
Setiap wajah di foto mendapat hasil: identified dengan uid dan similarity orang tersebut, atau unknown. Ambang naik seiring jumlah orang yang terdaftar, sehingga identifikasi yang salah tetap pada tingkat yang dikonfigurasi saat galeri Anda bertambah. Key memerlukan izin identify.
Mencobanya Di Dasbor
Sandbox menjalankan setiap panggilan ini dengan foto Anda sendiri dan menampilkan hasilnya dalam kata-kata, ditambah permintaan persisnya, jawaban mentahnya, dan panggilan yang sama dalam bentuk cURL untuk backend Anda.
Lihat Ambang untuk memilih seberapa ketat pencocokan.
API v2. Diperbarui 2026-11-12