DokumentasiENarsa.technology

Dokumentasi / SDK Pengenalan Wajah Dan Liveness / Deteksi Liveness

Deteksi Liveness

Pastikan wajah adalah orang yang hidup dan bukan foto cetak atau layar, dengan liveness pasif pada foto dan tantangan liveness aktif di edisi Prod.

Liveness Pasif (Prod Dan Demo)

Kirim satu sampai lima frame dari orang yang sama, yang diambil dalam rentang sekitar dua detik. Lima frame memberi hasil yang paling stabil.

curl -X POST http://localhost:8080/v2/liveness -H "x-api-key: $API_KEY" \
  -F image=@f1.jpg -F image=@f2.jpg -F image=@f3.jpg -F image=@f4.jpg -F image=@f5.jpg

Jawabannya adalah live, spoof atau inconclusive, beserta skor, ambang dan frame yang dipakai. Setiap frame harus memuat tepat satu wajah berukuran minimal 64 piksel, menoleh paling banyak 25 derajat; frame mana pun yang gagal membuat jawaban menjadi inconclusive, tidak pernah live.

profile Penggunaan
convenience (bawaan) Lebih sedikit pengguna asli yang ditolak
security Lebih sedikit serangan yang diterima, lebih banyak pengguna asli yang diminta mencoba lagi

Liveness pasif dibuat untuk foto cetak dan layar yang diputar ulang ke kamera. Fitur ini tidak dirancang untuk menghentikan topeng 3D.

Liveness Aktif (Prod)

Liveness aktif meminta orang mengikuti tantangan acak yang singkat, misalnya menoleh, dan dapat menambahkan kilatan warna dari layar. Klip yang disiapkan sebelumnya tidak dapat mengetahui tantangannya. Mulai sesi dengan POST /v2/liveness/sessions, alirkan kamera lewat WebSocket-nya, lalu baca hasil yang ditandatangani dari GET /v2/liveness/sessions/{id}. Server Anda dapat memeriksa tanda tangan hasil itu dengan kunci dari GET /v2/liveness/public-key.

Tips Pengambilan Gambar

  • Pakai kamera asli perangkat di halaman atau aplikasi yang Anda kendalikan.
  • Jaga wajah tetap besar dan cahayanya merata, menghadap kamera.
  • Minta pengguna mencoba lagi saat inconclusive: alasannya menjelaskan apa yang perlu diperbaiki.
Apakah halaman ini membantu?

API v2. Diperbarui 2026-11-12