Face Recognition Operations - Find Similar From Large Face List

Service:

Azure AI Services

API Version:

v1.1-preview.1

Büyük Yüz Listesi'nden benzer görünümlü yüzleri aramak için sorgu yüzünün faceId değeri verilir. İçerik Oluşturucu Büyük Yüz Listesi tarafından bir 'largeFaceListId' oluşturulur.
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.

Benzeri bul iki çalışma moduna sahiptir: "matchPerson" ve "matchFace". "matchPerson", aynı kişi eşiklerini kullanarak mümkün olduğunca aynı kişinin yüzlerini 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 değeriyle ilişkilendirilmiş 'recognitionModel' hedef Büyük Yüz Listesi 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 değerinin kalıcı olmadığını ve algılama çağrısından 24 saat sonra süresinin dolacağını unutmayın.
largeFaceListId	True	string	"İçerik Oluşturucu Büyük Yüz Listesi" içinde oluşturulan, kullanıcı tarafından belirtilen benzersiz aday Büyük Yüz Listesi. Büyük Yüz Listesi kalıcı olan ve süresi hiç dolmayan bir dizi kalıcıFaceId içerir.
maxNumOfCandidatesReturned		integer	Döndürülen en üstteki 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 veya giriş parametresi faceListId veya largeFaceListId ise persistedFaceId ise faceId'de temsil edilen en benzer yüzlerden oluşan bir dizi 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

Find Similar from LargeFaceList

Sample Request

HTTP

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

{
  "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
  "maxNumOfCandidatesReturned": 3,
  "mode": "matchPerson",
  "largeFaceListId": "your_large_face_list_id"
}

Sample Response

Status code:

200

[
  {
    "confidence": 0.8,
    "faceId": "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 aşağıdaki 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 tanıma işlemini bulmak 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 aşağıdaki 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 insanlar 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.

FindSimilarResult

Benzer yüz tanıma işlemini bulmak 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	faceIds 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 süresi dolar.
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.