Face Recognition Operations - Find Similar From Face List

  • Başvuru
Hizmet:
Azure AI Services
API Sürümü:
v1.2-preview.1

Bir Yüz Listesinden benzer görünümlü yüzleri aramak için sorgu yüzünün faceId değeri verilir. Yüz Tanıma Listesi Oluştur tarafından bir 'faceListId' 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, "matchPerson" ve "matchFace" adlı iki çalışma moduna sahiptir. "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şiklerden hiçbir yüz geçmezse 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üzler döndürür. Ünlü görünümlü yüzleri arama gibi durumlarda kullanılabilir.

Sorgu faceId değeriyle ilişkili 'recognitionModel' hedef Yüz Tanıma 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. Geçerli bir faceId elde etmek için kullanıcının ö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.
faceListId True

string

"Yüz Listesi Oluştur" içinde oluşturulan, kullanıcı tarafından belirtilen benzersiz aday Yüz Listesi. 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 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 veya giriş parametresi faceListId veya largeFaceListId ise kalıcıFaceId 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 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

Find Similar from FaceList

Örnek isteği

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

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

Örnek yanıt

Durum kodu:
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 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.
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 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.

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

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ü için persistedFaceId. yüz listesinde/büyük yüz listesinde persistedFaceId kalıcıdır ve süresi dolmaz.