Ana sayfa / Ürünler / Tanıma Motorları / Face Match Engine

ENGINE

Face Match Engine

Yığınınıza hazır yüz tanıma. Cams Face Match Engine, bir fotoğrafı kimliğe dönüştürür; ONNX ArcFace ve pasif sahtecilik önleme ile tam tespit, hizalama, embedding ve karşılaştırma işlem hattını çalıştırır — hepsi üç basit HTTPS endpoint'inin arkasında. Bir yüz görüntüsü veya önceden hesaplanmış bir embedding gönderin.

Başlayın Geliştirici dokümanları FaceUp'ı canlı deneyin ↗

Genel bakış

REST üzerinden sunucu tarafında yüz kaydı, 1:1 doğrulama ve 1:N tanımlama — yerleşik ArcFace embedding, SCRFD tespiti, hizalama ve sahtecilik önleme ile.

/api/biometric/v1/face/ adresinde kayıt, doğrulama (1:1) ve tanımlama (1:N) sunan bağımsız bir yüz tanıma servisi. Her görüntü SCRFD tespiti, benzerlik dönüşümlü 5 noktalı hizalama, MiniFASNet sınıfı sunum saldırısı tespiti ve ArcFace (insightface w600k_r50) 512 boyutlu embedding işlemlerinden geçer, ardından 0-100 arası skorlanan tam kosinüs benzerliği hesaplanır. Galeriler çok kiracılıdır, kiracı ve kullanıcı bazında kapsamlandırılır; hızlı 1:N için sıcak çözülmüş önbellek ve paylaşılan iş parçacığı havuzu kullanılır. Tek bir ONNX sağlayıcı anahtarıyla (CPU, CUDA, TensorRT veya OpenVINO) kod değişikliği olmadan GPU'ya hazırdır.

ENGINERESTHTTPSJSONC++

Kullanıldığı yerler:Nakitsiz Kantin ve Kafeterya Şantiyeler Filo, Ulaşım ve Sürücüler Spor Salonları, Kulüpler ve Fitness Ziyaretçi Yönetimi Okullar, Üniversiteler ve Kampüs Etkinlikler, Festivaller ve Stadyumlar

⚡

Canlı deneyin — FaceUp. Doğrudan tarayıcınızda yüz tanıma ile devam takibi — bir yüz kaydedin ve canlılık tespitiyle devam kaydı yapın, kurulacak uygulama yok. Oturum açmak gerekmez — cihaz seri numaranızla başlayın.

POST /api/biometric/v1/face/identify (1:N)

curl .../api/biometric/v1/face/identify \
  -H "sn: $SN" -H "auth-token: $TOKEN" \
  -d '{ "image": "<base64 jpeg>" }'
# -> detect -> PAD anti-spoof -> align -> ArcFace -> cosine
{ "ok":true, "match":true, "score":87,
  "candidates":5312, "user_id":"1042" }

Çalışırken görün

Face Match Engine — canlı demo

► Demoyu izle

Yetenekler

Neler yapar

Yüz Kaydetme

Kullanıcı başına bir veya daha fazla yüzü base64 görüntüden veya önceden hesaplanmış 512 boyutlu embedding'den kaydedin.

Doğrulama (1:1)

Yakalanan yüzün beyan edilen kullanıcıyla eşleştiğini doğrulayın; eşleşme bayrağı ve 0-100 skoru döner.

Tanımlama (1:N)

Yakalanan yüzü kiracının tüm galerisinde arayın ve eşiğin üzerindeki en iyi eşleşmeyi döndürün.

Sahtecilik Önleme (PAD)

MiniFASNet PAD, her doğrulama ve tanımlamada, herhangi bir embedding hesaplanmadan önce fotoğraf ve ekran tekrarlarını reddeder.

Kalite Denetimi

Kayıt sırasında çok küçük, bulanık, karanlık, parlak veya açısı kötü yüzleri reddeder; böylece galeriye yalnızca temiz şablonlar girer.

Ölçekli 1:N Eşleştirme

Sıcak bellek içi önbellek ve sınırlı iş parçacığı havuzu, kaba kuvvet kosinüs eşleştirmesini ~1M şablon aralığına kadar hızlı tutar.

Özellikler

Her şey dahil

Üç endpoint — kayıt, doğrulama (1:1) ve tanımlama (1:N) — base64 görüntü veya önceden hesaplanmış 512 boyutlu embedding kabul eder
0-100 arası skorlanan kosinüs eşleştirmeli ArcFace R50 (insightface w600k_r50) L2 normalize 512 boyutlu embedding'ler
Yerleşik SCRFD det_10g yüz tespiti ve ArcFace 112x112'ye kapalı biçimli 5 noktalı hizalama
Pasif tek kareli sahtecilik önleme (MiniFASNet PAD), embedding'den önce baskı ve ekran tekrarlarını reddeder
Kayıt anı kalite denetimi: ayarlanabilir eşiklerle yüz boyutu, keskinlik, parlaklık ve cepheden bakış kontrolleri
Kiracı ve kullanıcı bazında kapsamlandırılmış çok kiracılı galeriler; model yükseltmeleri boyunca model sürümü filtreleme
Kiracı bazında sıcak galeri önbelleği ve 1:N için paylaşılan iş parçacığı havuzu (ölçülen ~5,3 kat hızlanma, 1M şablonluk galeride ~104 ms)
CPU yedeğiyle ve kod değişikliği olmadan GPU'ya hazır ONNX sağlayıcı anahtarı (cpu/cuda/tensorrt/openvino)
Yapılandırılabilir eşleşme eşiği (varsayılan 60) ve güvenilmeyen uçlarda yalnızca görüntü girdisini zorunlu kılabilen bir girdi politikası

Face Match Engine ile geliştirin

Bir anahtar alın, dokümanları okuyun ve yayına alın. Ekibimiz ilk entegrasyonunuzda yardımcı olur.

Bir mühendisle görüşün WhatsApp

SSS

Sık sorulan sorular

Görüntü yerine önceden hesaplanmış bir embedding gönderebilir miyim?

Evet. İstekler bir JSON embedding dizisi veya base64 görüntü kabul eder. Embedding girdisi motor içinde tamamen canlı eşleştirilir; görüntü girdisi tam tespit-hizalama-PAD-embedding işlem hattını çalıştırır. Embedding girdisi, güvenilmeyen uçlarda politika ile devre dışı bırakılabilir.

Face Match Engine sahteciliği tespit eder mi?

Evet. Her doğrulama ve tanımlama, embedding'den önce tespit edilen yüz kırpmasında MiniFASNet pasif sahtecilik önleme (PAD) kontrolü yapar ve baskı ile ekran tekrarlarını reddeder. Bu, tek kareli RGB PAD'dir; 3D maskeler ve yüksek kaliteli video tekrarları derinlik veya IR donanımı gerektirir.

Hangi yüz tanıma modelini kullanır?

ArcFace R50 (insightface w600k_r50) L2 normalize 512 boyutlu embedding'ler üretir; tespit için SCRFD det_10g ve benzerlik dönüşümlü 5 noktalı hizalayıcı kullanılır.

GPU üzerinde çalışabilir mi?

Evet. ONNX sağlayıcıyı cuda (veya tensorrt/openvino) olarak ayarlayın; dedektör, embedding modeli ve PAD yapılandırılan sağlayıcıyı kullanır; CPU yedeği vardır ve kod değişikliği gerekmez.

1:N tanımlama ne kadar büyük bir galeriyi yönetebilir?

Kaba kuvvet kosinüs eşleştirmesi için sıcak çözülmüş önbellek ve paylaşılan iş parçacığı havuzu kullanır; 1M şablonluk galeride yaklaşık 104 ms ölçülmüştür; bunun ötesi için yol yaklaşık en yakın komşu indeksidir.