DokumentasiENarsa.technology

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.

Sandbox membandingkan dua foto orang yang sama: cocok pada 1 dari 10.000 penerimaan palsu

Lihat Ambang untuk memilih seberapa ketat pencocokan.

Apakah halaman ini membantu?

API v2. Diperbarui 2026-11-12