Face Recognition Operations - Identify From Dynamic Person Group

Hizmet:

Azure AI Services

API Sürümü:

v1.2

Dinamik Kişi Grubundan belirli bir sorgu kişisinin en yakın eşleşmelerini bulmak için 1-çok tanımlama.
FaceIds dizisindeki her yüz için Yüz Tanıma, sorgu yüzü ile Dinamik Kişi Grubundaki tüm yüzler arasındaki benzerlikleri hesaplar (dynamicPersonGroupId tarafından verilir) ve bu yüz için benzerlik güveni derecesine göre derecelenmiş aday kişileri döndürür.

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ımlanamaz.
  • 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.
  • Tanımla işlemi yalnızca sorgu yüzleriyle ilişkili aynı tanıma modeliyle elde edilen yüzleri eşleştirebilir.

POST {endpoint}/face/{apiVersion}/identify

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
dynamicPersonGroupId	True	string	Eşleşmesi gereken hedef PersonDirectory DynamicPersonGroup'un DynamicPersonGroupId değeri.
faceIds	True	string[] (uuid)	Sorgu dizisi, "Detect" tarafından oluşturulan faceId değerleriyle yüzleşir. Yüzlerin her biri bağımsız olarak tanımlanır. Geçerli faceId sayısı [1, 10] arasındadır.
confidenceThreshold		number (float) minimum: 0 maximum: 1	[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ışmasının garantisi olmadığını unutmayın.
maxNumOfCandidatesReturned		integer (int32) minimum: 1 maximum: 100	maxNumOfCandidatesReturned aralığı 1 ile 100 arasındadır. Varsayılan değer 10'dur.

Yanıtlar

Name	Tür	Description
200 OK	IdentificationResult[]	Başarılı bir çağrı, her sorgu yüzü için tanımlanan aday kişilerini 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

Identify from DynamicPersonGroup

Örnek isteği

HTTP

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

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "dynamicPersonGroupId": "your_dynamic_person_group_id",
  "maxNumOfCandidatesReturned": 9,
  "confidenceThreshold": 0.7
}

Örnek yanıt

Durum kodu:

200

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "candidates": [
      {
        "personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
        "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.
IdentificationCandidate	Aramayı tanımlamak için aday.
IdentificationResult	Sonucu tanımlayı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.

IdentificationCandidate

Object

Aramayı tanımlamak için aday.

Name	Tür	Description
confidence	number (float) minimum: 0 maximum: 1	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 (uuid)	aday kişinin personId değeri.

IdentificationResult

Object

Sonucu tanımlayın.

Name	Tür	Description
candidates	IdentificationCandidate[]	Bu yüz için tanımlanan 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 (uuid)	Sorgu yüzünün faceId değeri.