Face Recognition Operations - Find Similar
FaceId wajah kueri yang diberikan, untuk mencari wajah yang tampak serupa dari array faceId. Array faceId berisi wajah yang dibuat oleh Detect.
Bergantung pada input daftar wajah serupa yang dikembalikan berisi faceIds atau persistedFaceIds yang diberi peringkat oleh kesamaan.
Temukan yang serupa memiliki dua mode kerja, "matchPerson" dan "matchFace". "matchPerson" adalah mode default yang mencoba menemukan wajah orang yang sama dengan mungkin dengan menggunakan ambang batas internal orang yang sama. Sangat berguna untuk menemukan foto orang yang dikenal lainnya. Perhatikan bahwa daftar kosong akan dikembalikan jika tidak ada wajah yang melewati ambang internal. Mode "matchFace" mengabaikan ambang batas orang yang sama dan tetap mengembalikan wajah serupa peringkat, bahkan kesamaannya rendah. Ini dapat digunakan dalam kasus-kasus seperti mencari wajah yang tampak selebriti.
'recognitionModel' yang terkait dengan faceId kueri harus sama dengan 'recognitionModel' yang digunakan oleh array faceId target.
POST {endpoint}/face/{apiVersion}/findsimilars
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
api
|
path | True |
string |
Versi API |
endpoint
|
path | True |
string uri |
Titik akhir Cognitive Services yang didukung (protokol dan nama host, misalnya: https://{resource-name}.cognitiveservices.azure.com). |
Isi Permintaan
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
faceId | True |
string |
faceId wajah kueri. Pengguna perlu memanggil "Deteksi" terlebih dahulu untuk mendapatkan faceId yang valid. Perhatikan bahwa faceId ini tidak bertahan dan akan kedaluwarsa 24 jam setelah panggilan deteksi. |
faceIds | True |
string[] |
Array faceIds kandidat. Semuanya dibuat oleh "Deteksi" dan faceId akan kedaluwarsa 24 jam setelah panggilan deteksi. Jumlah faceId dibatasi hingga 1000. |
maxNumOfCandidatesReturned |
integer |
Jumlah wajah serupa teratas yang dikembalikan. Rentang yang valid adalah [1, 1000]. Nilai default adalah 20. |
|
mode |
Find |
Mode pencarian wajah serupa. Ini bisa berupa 'matchPerson' atau 'matchFace'. Nilai defaultnya adalah 'matchPerson'. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
Panggilan yang berhasil mengembalikan array wajah yang paling mirip yang diwakili dalam faceId jika parameter input adalah faceIds atau persistedFaceId jika parameter inputnya adalah faceListId atau largeFaceListId. |
|
Other Status Codes |
Respons kesalahan yang tidak terduga. Header x-ms-error-code: string |
Keamanan
Ocp-Apim-Subscription-Key
Kunci rahasia untuk langganan Azure AI Face Anda.
Jenis:
apiKey
Dalam:
header
AADToken
Alur OAuth2 Azure Active Directory
Jenis:
oauth2
Alur:
accessCode
URL Otorisasi:
https://api.example.com/oauth2/authorize
URL token:
https://api.example.com/oauth2/token
Cakupan
Nama | Deskripsi |
---|---|
https://cognitiveservices.azure.com/.default |
Contoh
Find Similar among Face IDs
Permintaan sampel
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"
]
}
Respon sampel
[
{
"confidence": 0.9,
"persistedFaceId": "015839fb-fbd9-4f79-ace9-7675fc2f1dd9"
}
]
Definisi
Nama | Deskripsi |
---|---|
Face |
Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Face Service, silakan lihat tautan berikut: https://aka.ms/face-error-codes-and-messages. |
Face |
Respons yang berisi detail kesalahan. |
Find |
Isi respons untuk menemukan operasi wajah yang serupa. |
FaceError
Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Face Service, silakan lihat tautan berikut: https://aka.ms/face-error-codes-and-messages.
Nama | Jenis | Deskripsi |
---|---|---|
code |
string |
Salah satu set kode kesalahan yang ditentukan server. |
message |
string |
Representasi kesalahan yang dapat dibaca manusia. |
FaceErrorResponse
Respons yang berisi detail kesalahan.
Nama | Jenis | Deskripsi |
---|---|---|
error |
Objek kesalahan. |
FindSimilarResult
Isi respons untuk menemukan operasi wajah yang serupa.
Nama | Jenis | Deskripsi |
---|---|---|
confidence |
number |
Nilai keyakinan kandidat. Semakin tinggi kepercayaan diri, semakin mirip. Rentang antara [0,1]. |
faceId |
string |
faceId wajah kandidat ketika ditemukan oleh faceIds. faceId dibuat oleh "Deteksi" dan akan kedaluwarsa 24 jam setelah panggilan deteksi. |
persistedFaceId |
string |
persistedFaceId dari wajah kandidat saat ditemukan oleh faceListId atau largeFaceListId. persistedFaceId dalam daftar wajah/daftar wajah besar tetap ada dan tidak akan kedaluwarsa. |