Face Recognition Operations - Find Similar

Hizmet:

Azure AI Services

API Sürümü:

v1.1-preview.1

Bir faceId dizisinden benzer görünümlü yüzleri aramak için sorgu yüzünün faceId değeri verilir. faceId dizisi Detect tarafından oluşturulan yüzleri içerir.
Girişe bağlı olarak, döndürülen benzer yüzler listesinde benzerlik derecesine göre derecelenmiş faceId'ler veya kalıcıFaceId'ler bulunur.

Find benzer iki çalışma modu vardır: "matchPerson" ve "matchFace". "matchPerson", aynı kişinin yüzlerini iç aynı kişi eşiklerini kullanarak mümkün olduğunca bulmaya çalıştığı varsayılan moddur. Bilinen bir kişinin diğer fotoğraflarını bulmak yararlıdır. İç eşikleri geçen yüz yoksa boş bir listenin döndürüleceğini unutmayın. "matchFace" modu aynı kişi eşiklerini yoksayar ve benzerliği düşük olsa bile dereceli benzer yüzleri döndürür. Ünlü görünümlü yüzleri arama gibi durumlarda kullanılabilir.

sorgu faceId ile ilişkili 'recognitionModel', hedef faceId dizisi tarafından kullanılan 'recognitionModel' ile aynı olmalıdır.

POST {endpoint}/face/{apiVersion}/findsimilars

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	Sorgu yüzünün faceId değeri. Kullanıcının geçerli bir faceId almak için önce "Detect" çağrısı yapması gerekir. Bu faceId'nin kalıcı olmadığını ve algılama çağrısından 24 saat sonra süresinin dolacağını unutmayın.
faceIds	True	string[]	Bir dizi aday faceId. Bunların tümü "Algıla" tarafından oluşturulur ve algılama çağrısından 24 saat sonra faceId'lerin süresi dolar. FaceId sayısı 1000 ile sınırlıdır.
maxNumOfCandidatesReturned		integer	Döndürülen en iyi benzer yüzlerin sayısı. Geçerli aralık : [1, 1000]. Varsayılan değer 20'dir.
mode		FindSimilarMatchMode	Benzer yüz arama modu. 'matchPerson' veya 'matchFace' olabilir. Varsayılan değer :'matchPerson'.

Yanıtlar

Name	Tür	Description
200 OK	FindSimilarResult[]	Başarılı bir çağrı, giriş parametresi faceIds ise faceId veya giriş parametresi faceListId veya largeFaceListId ise faceId ile temsil edilen en benzer yüzlerden oluşan bir dizi 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 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

Find Similar among Face IDs

Örnek isteği

HTTP

POST {endpoint}/face/v1.1-preview.1/findsimilars

{
  "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
  "maxNumOfCandidatesReturned": 3,
  "mode": "matchPerson",
  "faceIds": [
    "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
    "be386ab3-af91-4104-9e6d-4dae4c9fddb7"
  ]
}

Örnek yanıt

Durum kodu:

200

[
  {
    "confidence": 0.9,
    "persistedFaceId": "015839fb-fbd9-4f79-ace9-7675fc2f1dd9"
  }
]

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.
FindSimilarResult	Benzer yüz bulma işlemi için yanıt gövdesi.

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.

FindSimilarResult

Benzer yüz bulma işlemi için yanıt gövdesi.

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.
faceId	string	faceId'ler tarafından bulunca aday yüzünün faceId değeri. faceId , "Detect" tarafından oluşturulur ve algılama çağrısından 24 saat sonra sona erer.
persistedFaceId	string	faceListId veya largeFaceListId tarafından bulunca aday yüzünün persistedFaceId değeri. yüz listesinde/büyük yüz listesinde persistedFaceId kalıcıdır ve süresi dolmaz.