Face Recognition Operations - Identify From Large Person Group

Service:

Azure AI Services

API Version:

v1.1-preview.1

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
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
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	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ı. Headers x-ms-error-code: string

Güvenlik

Ocp-Apim-Subscription-Key

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

Type: apiKey
In: header

AADToken

Azure Active Directory OAuth2 Akışı

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

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

Örnekler

Identify from LargePersonGroup

Sample Request

HTTP

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
}

Sample Response

Status code:

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 kapsamlı ayrıntılar 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	Arama kimliğini belirleme adayı.
IdentificationResult	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	FaceError	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	IdentificationCandidate[]	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.