Face Recognition Operations - Verify From Person Group

Hizmet:

Azure AI Services

API Sürümü:

v1.2

Yüzün Bir Kişi Grubundaki bir kişiye ait olup olmadığını doğrulayın.

Not

• • Daha yüksek yüz görüntüsü kalitesi, daha iyi tanımlama duyarlığı anlamına gelir. Lütfen yüksek kaliteli yüzleri göz önünde bulundurun: ön, net ve yüz boyutu 200x200 piksel (gözler arasında 100 piksel) veya daha büyük.
  • Doğruluk açısından hassas senaryolar için lütfen kendi kararınızı verin.
  • Sorgu yüzüyle ilişkili 'recognitionModel', Kişi Grubu tarafından kullanılan 'recognitionModel' ile aynı olmalıdır.

POST {endpoint}/face/{apiVersion}/verify

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
apiVersion	path	True	string	API Sürümü
endpoint	path	True	string (uri)	Desteklenen Bilişsel Hizmetler uç noktaları (protokol ve konak adı, örneğin: https://{resource-name}.cognitiveservices.azure.com).

İstek Gövdesi

Name	Gerekli	Tür	Description
faceId	True	string (uuid)	Yüzün faceId değeri "Detect" (Algıla) bölümünden gelir.
personGroupId	True	string	Belirtilen bir kişiyi hızlı yüklemek için mevcut personGroupId ve personId kullanma. personGroupId , "Kişi Grubu Oluştur" içinde oluşturulur.
personId	True	string (uuid)	Kişi Grubu'nda belirli bir kişiyi belirtin.

Yanıtlar

Name	Tür	Description
200 OK	VerificationResult	Başarılı bir çağrı doğrulama sonucunu döndürür.
Other Status Codes	FaceErrorResponse	Beklenmeyen bir hata yanıtı. Üst Bilgiler x-ms-error-code: string

Güvenlik

Ocp-Apim-Subscription-Key

Azure Yapay Zeka Yüz Tanıma aboneliğinizin gizli anahtarı.

Tür: apiKey
İçinde: header

AADToken

Azure Active Directory OAuth2 Akışı

Tür: oauth2
Akış: accessCode
Yetkilendirme URL’si: https://api.example.com/oauth2/authorize
Belirteç URL'si: https://api.example.com/oauth2/token

Kapsamlar

Name	Description
https://cognitiveservices.azure.com/.default

Örnekler

Verify from PersonGroup

Örnek isteği

HTTP

POST {endpoint}/face/v1.2/verify

{
  "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
  "personId": "815df99c-598f-4926-930a-a734b3fd651c",
  "personGroupId": "your_person_group"
}

Örnek yanıt

Durum kodu:

200

{
  "isIdentical": true,
  "confidence": 0.8
}

Tanımlar

Name	Description
FaceError	Hata nesnesi. Yüz Tanıma Hizmeti tarafından döndürülen hata kodları ve iletiler hakkında ayrıntılı bilgi için lütfen şu bağlantıya bakın: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Hata ayrıntılarını içeren bir yanıt.
VerificationResult	Sonucu doğrulayın.

FaceError

Object

Hata nesnesi. Yüz Tanıma Hizmeti tarafından döndürülen hata kodları ve iletiler hakkında ayrıntılı bilgi için lütfen şu bağlantıya bakın: https://aka.ms/face-error-codes-and-messages.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
message	string	Hatanın insan tarafından okunabilir bir gösterimi.

FaceErrorResponse

Object

Hata ayrıntılarını içeren bir yanıt.

Name	Tür	Description
error	FaceError	Hata nesnesi.

VerificationResult

Object

Sonucu doğrulayın.

Name	Tür	Description
confidence	number (float) minimum: 0 maximum: 1	Sayı, iki yüzün aynı kişiye ait olup olmadığına veya yüzün kişiye ait olup olmadığına ilişkin benzerlik güvenini gösterir. Benzerlik güveni 0,5'ten büyük veya buna eşitse, varsayılan olarak isIdentical değeri True olarak ayarlanır. Bu, ileri düzey kullanıcıların 'isIdentical' öğesini geçersiz kılıp sonucu kendi verilerinde ince ayarlamaları için kullanışlıdır.
isIdentical	boolean	İki yüz aynı kişiye aitse veya yüz kişiye aitse doğru, aksi halde yanlış.