Face Recognition Operations - Identify From Large Person Group

  • Başvuru
Hizmet:
Azure AI Services
API Sürümü:
v1.2-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 derecelenmiş aday kişileri döndürür. Büyük Kişi Grubu, tanımlamaya hazır hale getirmek için eğitilmelidir. Daha fazla bilgi için bkz. "Büyük Kişi Grubunu Eğit".

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.
    • 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şkilendirilmiş 'recognitionModel' faceId'leri, 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[]

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.
largePersonGroupId True

string

"Büyük Kişi Grubu Oluştur" tarafından oluşturulan hedef Büyük Kişi Grubunun largePersonGroupId değeri. personGroupId parametresi ve largePersonGroupId 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ışmasının garantisi 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ı.

Ü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 LargePersonGroup

Örnek isteği

POST {endpoint}/face/v1.2-preview.1/identify

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "largePersonGroupId": "your_large_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

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

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

Name Tür Description
error

FaceError

Hata nesnesi.

IdentificationCandidate

Aramayı tanımlamak için 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ı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

Sorgu yüzünün faceId değeri.