DokumentasiENarsa.technology

Dokumentasi / SDK Pengenalan Wajah Dan Liveness / Perubahan Dari Face SDK v1

Perubahan Dari Face SDK v1

Apa yang berubah di Face SDK v2 dibandingkan v1, cara klien v1 yang ada tetap berfungsi, dan langkah memindahkan orang, key dan instalasi ke v2.

Yang Baru

  • API v2: jawaban yang lebih jelas (setiap keputusan disertai skor dan ambangnya), alasan kualitas foto, dokumen problem dengan kode galat yang tetap, izin per key.
  • Dasbor: Sandbox, referensi API, log permintaan, log audit, orang, tampilan live dan pengaturan, dengan aplikasi autentikator di setiap kali masuk.
  • Kamera dan video langsung (Prod): kamera RTSP dengan peristiwa pengenalan, webhook dan video langsung di dasbor.
  • Ambang yang diukur per tingkat penerimaan palsu (false accept rate), dan ambang identifikasi yang mengikuti ukuran galeri Anda.
  • Privasi: template terenkripsi, pengaturan retensi, log audit, tidak ada foto yang disimpan.
  • Instalasi satu perintah dan sistem lisensi baru.

Klien v1 Anda Tetap Berfungsi

API v1 dilayani di /api/v1 dengan path, header (x-key-secret, x-face-uid), kolom formulir dan jawaban yang sama. Pakai API key v2 sebagai x-key-secret. Perbedaannya:

  • age selalu null (perkiraan usia tidak disediakan); jenis kelamin dan ekspresi bernilai null kecuali diaktifkan.
  • recognition_confidence adalah skor kemiripan; pencocokan memakai ambang yang terukur, dan tidak lagi memakai nilai tetap 0.5.
  • Pendaftaran lebih ketat dan menolak duplikat.
  • API video liveness aktif v1 menjawab 410 Gone; pakai liveness v2.

Integrasi baru sebaiknya memakai v2.

Pindah Ke v2

  1. Daftarkan ulang semua orang. v2 memakai model pengenalan yang berbeda dan data wajah v1 tidak dapat dikonversi. Daftarkan orang lagi dari foto mereka dengan ID yang sama. Biarkan v1 tetap berjalan sampai langkah ini selesai.
  2. Image dan kunci baru. Image Demo adalah arsatech/face-sdk (v1 memakai arsatech/face-sdk-demo), dan v2 memerlukan kunci lisensi v2.
  3. API key baru. Buat key v2 di dasbor untuk setiap sistem.
Apakah halaman ini membantu?

API v2. Diperbarui 2026-11-12