Face Recognition Operations - Identify From Dynamic Person Group
Identifikasi 1-ke-banyak untuk menemukan kecocokan terdekat dari wajah orang kueri tertentu dari Grup Orang Dinamis.
Untuk setiap wajah dalam array faceIds, Face Identifi akan menghitung kesamaan antara wajah kueri dan semua wajah dalam Grup Orang Dinamis (diberikan oleh dynamicPersonGroupId), dan mengembalikan orang kandidat untuk wajah yang diberi peringkat oleh keyakinan kesamaan.
Catatan
-
- Algoritma memungkinkan lebih dari satu wajah diidentifikasi secara independen pada permintaan yang sama, tetapi tidak lebih dari 10 wajah.
- Setiap orang bisa memiliki lebih dari satu wajah, tetapi tidak lebih dari 248 wajah.
- Kualitas gambar wajah yang lebih tinggi berarti presisi identifikasi yang lebih baik. Harap pertimbangkan wajah berkualitas tinggi: frontal, clear, dan ukuran wajah adalah 200x200 piksel (100 piksel antar mata) atau lebih besar.
- Jumlah kandidat yang dikembalikan dibatasi oleh maxNumOfCandidatesReturned dan confidenceThreshold. Jika tidak ada orang yang diidentifikasi, kandidat yang dikembalikan akan menjadi array kosong.
- Operasi Identifikasi hanya dapat mencocokkan wajah yang diperoleh dengan model pengenalan yang sama, yang terkait dengan wajah kueri.
POST {endpoint}/face/{apiVersion}/identify
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 |
---|---|---|---|
dynamicPersonGroupId | True |
string |
DynamicPersonGroupId dari target PersonDirectory DynamicPersonGroup untuk dicocokkan. |
faceIds | True |
string[] |
Array kueri menghadap faceIds, yang dibuat oleh "Deteksi". Masing-masing wajah diidentifikasi secara independen. Jumlah faceIds yang valid adalah antara [1, 10]. |
confidenceThreshold |
number |
Ambang keyakinan identifikasi yang disesuaikan, dalam kisaran [0, 1]. Pengguna tingkat lanjut dapat mengubah nilai ini untuk mengambil alih ambang internal default untuk presisi yang lebih baik pada data skenario mereka. Perhatikan bahwa tidak ada jaminan nilai ambang ini bekerja pada data lain dan setelah pembaruan algoritma. |
|
maxNumOfCandidatesReturned |
integer |
Rentang maxNumOfCandidatesReturned adalah antara 1 dan 100. Nilai defaultnya adalah 10. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
Panggilan yang berhasil mengembalikan orang kandidat yang diidentifikasi untuk setiap wajah kueri. |
|
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
Identify from DynamicPersonGroup
Permintaan sampel
POST {endpoint}/face/v1.1-preview.1/identify
{
"faceIds": [
"c5c24a82-6845-4031-9d5d-978df9175426"
],
"dynamicPersonGroupId": "your_dynamic_person_group_id",
"maxNumOfCandidatesReturned": 9,
"confidenceThreshold": 0.7
}
Respon sampel
[
{
"faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
"candidates": [
{
"personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
"confidence": 0.8
}
]
}
]
Definisi
Nama | Deskripsi |
---|---|
Face |
Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Layanan Wajah, silakan lihat tautan berikut: https://aka.ms/face-error-codes-and-messages. |
Face |
Respons yang berisi detail kesalahan. |
Identification |
Kandidat untuk mengidentifikasi panggilan. |
Identification |
Identifikasi hasil. |
FaceError
Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Layanan Wajah, 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. |
IdentificationCandidate
Kandidat untuk mengidentifikasi panggilan.
Nama | Jenis | Deskripsi |
---|---|---|
confidence |
number |
Nilai keyakinan kandidat. Semakin tinggi keyakinan, semakin mirip. Rentang antara [0,1]. |
personId |
string |
personId orang kandidat. |
IdentificationResult
Identifikasi hasil.
Nama | Jenis | Deskripsi |
---|---|---|
candidates |
Kandidat orang yang diidentifikasi untuk wajah tersebut (diberi peringkat dengan keyakinan). Ukuran array tidak boleh lebih besar dari input maxNumOfCandidatesReturned. Jika tidak ada orang yang diidentifikasi, akan mengembalikan array kosong. |
|
faceId |
string |
faceId wajah kueri. |