Face Recognition Operations - Identify From Large Person Group
Büyük Kişi Grubundan belirli bir sorgu kişisinin en yakın eşleşmelerini bulmak için 1-çok kimlik.
FaceIds dizisindeki her yüz için Yüz Tanıma, sorgu yüzü ile Büyük Kişi Grubundaki tüm yüzler arasındaki benzerlikleri hesaplar (largePersonGroupId tarafından verilir) ve bu yüz için benzerlik güveni derecesine göre sıralanan aday kişileri döndürür. Büyük Kişi Grubu, tanımlamaya hazır hale getirmek için eğitilmelidir. "Büyük Kişi Grubunu Eğit" bölümünde daha fazla bilgi edinebilirsiniz.
Not
-
- Algoritma, aynı istekte birden fazla yüzün bağımsız olarak tanımlanmasına izin verir, ancak 10'dan fazla yüz tanımaz.
- Her kişinin birden fazla yüzü olabilir, ancak en fazla 248 yüz olabilir.
- 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.
- Döndürülen aday sayısı maxNumOfCandidatesReturned ve confidenceThreshold ile kısıtlanır. Hiçbir kişi tanımlanamazsa, döndürülen adaylar boş bir dizi olur.
- Kişi Grubu/Büyük Kişi Grubu yerine Yüz Listesi/Büyük Yüz Listesi'nden benzer yüzler bulmanız gerektiğinde "Benzerini Bul"u deneyin.
- Sorgu yüzleriyle ilişkili 'recognitionModel' faceId değerleri, hedef Kişi Grubu veya Büyük Kişi Grubu tarafından kullanılan 'recognitionModel' ile aynı olmalıdır.
POST {endpoint}/face/{apiVersion}/identify
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
api
|
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 |
---|---|---|---|
faceIds | True |
string[] |
"Algıla" tarafından oluşturulan faceId sorgu yüzleri dizisi. Yüzlerin her biri bağımsız olarak tanımlanır. Geçerli faceId sayısı [1, 10] arasındadır. |
largePersonGroupId | True |
string |
"İçerik Oluşturucu Büyük Kişi Grubu" tarafından oluşturulan hedef Büyük Kişi Grubunun largePersonGroupId değeri. personGroupId ve largePersonGroupId parametresi aynı anda sağlanmamalıdır. |
confidenceThreshold |
number |
[0, 1] aralığında özelleştirilmiş tanımlama güven eşiği. Gelişmiş kullanıcı, senaryo verilerinde daha iyi duyarlık için varsayılan iç eşiği geçersiz kılmak için bu değeri değiştirebilir. Bu eşik değerinin diğer verilerde ve algoritma güncelleştirmelerinden sonra çalışacağına ilişkin bir garanti olmadığını unutmayın. |
|
maxNumOfCandidatesReturned |
integer |
maxNumOfCandidatesReturned aralığı 1 ile 100 arasındadır. Varsayılan değer 10'dur. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Başarılı bir çağrı, her sorgu yüzü için tanımlanan aday kişilerini döndürür. |
|
Other Status Codes |
Beklenmeyen bir hata yanıtı. Üst Bilgiler x-ms-error-code: string |
Güvenlik
Ocp-Apim-Subscription-Key
Azure AI 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
Identify from LargePersonGroup
Örnek isteği
POST {endpoint}/face/v1.1-preview.1/identify
{
"faceIds": [
"c5c24a82-6845-4031-9d5d-978df9175426"
],
"largePersonGroupId": "your_large_person_group_id",
"maxNumOfCandidatesReturned": 9,
"confidenceThreshold": 0.7
}
Örnek yanıt
[
{
"faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
"candidates": [
{
"personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
"confidence": 0.8
}
]
}
]
Tanımlar
Name | Description |
---|---|
Face |
Hata nesnesi. Yüz Tanıma Hizmeti tarafından döndürülen hata kodları ve iletiler hakkında kapsamlı ayrıntılar için lütfen şu bağlantıya bakın: https://aka.ms/face-error-codes-and-messages. |
Face |
Hata ayrıntılarını içeren bir yanıt. |
Identification |
Arama kimliğini belirleme adayı. |
Identification |
Sonucu tanımlama. |
FaceError
Hata nesnesi. Yüz Tanıma Hizmeti tarafından döndürülen hata kodları ve iletiler hakkında kapsamlı ayrıntılar 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 okunabilen bir gösterimi. |
FaceErrorResponse
Hata ayrıntılarını içeren bir yanıt.
Name | Tür | Description |
---|---|---|
error |
Hata nesnesi. |
IdentificationCandidate
Arama kimliğini belirleme adayı.
Name | Tür | Description |
---|---|---|
confidence |
number |
Adayın güvenilirlik değeri. Güvenilirlik ne kadar yüksek olursa, o kadar benzer olur. [0,1] arasındaki aralık. |
personId |
string |
aday kişinin personId değeri. |
IdentificationResult
Sonucu tanımlama.
Name | Tür | Description |
---|---|---|
candidates |
Bu yüz için belirlenen kişi adayları (güvene göre derecelendirilir). Dizi boyutu maxNumOfCandidatesReturned girişinden büyük olmamalıdır. Hiçbir kişi tanımlanmazsa boş bir dizi döndürür. |
|
faceId |
string |
Sorgu yüzünün faceId değeri. |