Liveness Session Operations - Get Liveness With Verify Session Audit Entries
Mendapatkan permintaan sesi dan isi respons untuk sesi tersebut.
GET {endpoint}/face/{apiVersion}/detectLivenessWithVerify/singleModal/sessions/{sessionId}/audit
GET {endpoint}/face/{apiVersion}/detectLivenessWithVerify/singleModal/sessions/{sessionId}/audit?start={start}&top={top}
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). |
session
|
path | True |
string |
ID unik untuk mereferensikan sesi ini. |
start
|
query |
string |
Mencantumkan sumber daya yang lebih besar dari "mulai". Ini berisi tidak lebih dari 64 karakter. Defaultnya kosong. |
|
top
|
query |
integer int32 |
Jumlah item yang akan dicantumkan, berkisar di [1, 1000]. Defaultnya adalah 1000. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
Permintaan telah berhasil. |
|
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
Get LivenessWithVerify Session Audit Entries
Permintaan sampel
GET {endpoint}/face/v1.1-preview.1/detectLivenessWithVerify/singleModal/sessions/b12e033e-bda7-4b83-a211-e721c661f30e/audit?start=0&top=20
Respon sampel
[
{
"id": 4,
"sessionId": "b12e033e-bda7-4b83-a211-e721c661f30e",
"requestId": "4af681e9-0e25-43e9-9922-a7adebf13b2f",
"clientRequestId": "4af681e9-0e25-43e9-9922-a7adebf13b2f",
"receivedDateTime": "2024-03-05T11:07:29.698Z",
"request": {
"url": "/face/v1.1-preview.1/detectliveness/singlemodal",
"method": "POST",
"contentLength": 18,
"contentType": "multipart/form-data",
"userAgent": "Mozilla/5.0 (Linux) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Mobile Safari/537.36"
},
"response": {
"body": {},
"statusCode": 200,
"latencyInMilliseconds": 1200
},
"digest": "1CC98BA83EAF1D0FF7F566FAEFCCCC787819FFA01251E2D9299143F7AD6651DB"
}
]
Definisi
Nama | Deskripsi |
---|---|
Audit |
Entri audit untuk respons dalam sesi. |
Audit |
Entri audit untuk permintaan dalam sesi. |
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. |
Face |
Persegi panjang di mana wajah dapat ditemukan. |
Image |
Jenis gambar. |
Liveness |
Hasil klasifikasi keaktifan. |
Liveness |
Versi model yang digunakan untuk klasifikasi keaktifan. |
Liveness |
Klasifikasi keaktifan untuk wajah target. |
Liveness |
Isi respons mendeteksi panggilan API keaktifan. |
Liveness |
Entri audit untuk permintaan dalam sesi. |
Liveness |
Detail wajah untuk verifikasi. |
Liveness |
Output verifikasi wajah. |
Quality |
Menunjukkan kualitas gambar untuk pengenalan. |
AuditLivenessResponseInfo
Entri audit untuk respons dalam sesi.
Nama | Jenis | Deskripsi |
---|---|---|
body |
Isi respons. Skema bidang ini akan bergantung pada request.url dan request.method yang digunakan oleh klien. |
|
latencyInMilliseconds |
integer |
Latensi terukur server untuk permintaan ini dalam milidetik. |
statusCode |
integer |
Kode status HTTP dikembalikan ke klien. |
AuditRequestInfo
Entri audit untuk permintaan dalam sesi.
Nama | Jenis | Deskripsi |
---|---|---|
contentLength |
integer |
Panjang isi permintaan dalam byte. |
contentType |
string |
Jenis konten permintaan. |
method |
string |
Metode HTTP permintaan (yaitu, GET, POST, DELETE). |
url |
string |
URL relatif dan kueri permintaan keaktifan. |
userAgent |
string |
Agen pengguna yang digunakan untuk mengirimkan permintaan. |
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. |
FaceRectangle
Persegi panjang di mana wajah dapat ditemukan.
Nama | Jenis | Deskripsi |
---|---|---|
height |
integer |
Tinggi persegi panjang, dalam piksel. |
left |
integer |
Jarak dari tepi kiri jika gambar ke tepi kiri persegi panjang, dalam piksel. |
top |
integer |
Jarak dari tepi atas jika gambar ke tepi atas persegi panjang, dalam piksel. |
width |
integer |
Lebar persegi panjang, dalam piksel. |
ImageType
Jenis gambar.
Nama | Jenis | Deskripsi |
---|---|---|
Color |
string |
Gambar warna. |
Depth |
string |
Gambar kedalaman. |
Infrared |
string |
Gambar inframerah. |
LivenessDecision
Hasil klasifikasi keaktifan.
Nama | Jenis | Deskripsi |
---|---|---|
realface |
string |
Algoritma telah mengklasifikasikan wajah target sebagai nyata. |
spoofface |
string |
Algoritma telah mengklasifikasikan wajah target sebagai spoof. |
uncertain |
string |
Algoritma tidak dapat mengklasifikasikan wajah target sebagai nyata atau spoof. |
LivenessModel
Versi model yang digunakan untuk klasifikasi keaktifan.
Nama | Jenis | Deskripsi |
---|---|---|
2022-10-15-preview.04 |
string |
|
2023-12-20-preview.06 |
string |
LivenessOutputsTarget
Klasifikasi keaktifan untuk wajah target.
Nama | Jenis | Deskripsi |
---|---|---|
faceRectangle |
Wilayah wajah tempat klasifikasi keaktifan dibuat. |
|
fileName |
string |
Nama file yang berisi persegi wajah tempat klasifikasi keaktifan dibuat. |
imageType |
Jenis gambar yang berisi persegi panjang wajah tempat klasifikasi keaktifan dibuat. |
|
timeOffsetWithinFile |
integer |
Offset waktu dalam file bingkai yang berisi persegi wajah tempat klasifikasi keaktifan dibuat. |
LivenessResponseBody
Isi respons mendeteksi panggilan API keaktifan.
Nama | Jenis | Deskripsi |
---|---|---|
livenessDecision |
Klasifikasi keaktifan untuk wajah target. |
|
modelVersionUsed |
Versi model yang digunakan untuk klasifikasi keaktifan. |
|
target |
Target khusus yang digunakan untuk klasifikasi keaktifan. |
|
verifyResult |
Output verifikasi wajah. Hanya tersedia ketika permintaan adalah keaktifan dengan verifikasi. |
LivenessSessionAuditEntry
Entri audit untuk permintaan dalam sesi.
Nama | Jenis | Deskripsi |
---|---|---|
clientRequestId |
string |
ClientRequestId unik yang dikirim oleh klien di header 'client-request-id'. |
digest |
string |
Server menghitung hash untuk permintaan ini. Jika digest yang dilaporkan klien berbeda dari hash yang dihitung server, maka integritas pesan antara klien dan layanan telah disusupi dan hasilnya tidak boleh dipercaya. Untuk informasi selengkapnya, lihat cara memandu tentang cara memanfaatkan nilai ini untuk mengamankan solusi end-to-end Anda. |
id |
integer |
Id unik untuk merujuk ke permintaan audit ini. Gunakan id ini dengan parameter kueri 'mulai' untuk melanjutkan ke halaman hasil audit berikutnya. |
receivedDateTime |
string |
DateTime UTC yang diterima permintaan. |
request |
Permintaan entri ini. |
|
requestId |
string |
RequestId unik yang dikembalikan oleh layanan ke klien di header 'apim-request-id'. |
response |
Respons entri ini. |
|
sessionId |
string |
SessionId unik dari sesi yang dibuat. Ini akan kedaluwarsa 48 jam setelah dibuat atau dapat dihapus lebih cepat menggunakan operasi DELETE sesi yang sesuai. |
LivenessWithVerifyImage
Detail wajah untuk verifikasi.
Nama | Jenis | Deskripsi |
---|---|---|
faceRectangle |
Wilayah wajah tempat klasifikasi gambar perbandingan dibuat. |
|
qualityForRecognition |
Kualitas gambar wajah untuk pengenalan. |
LivenessWithVerifyOutputs
Output verifikasi wajah.
Nama | Jenis | Deskripsi |
---|---|---|
isIdentical |
boolean |
Apakah wajah keaktifan target dan kecocokan wajah gambar perbandingan. |
matchConfidence |
number |
Wajah keaktifan wajah target dan keyakinan verifikasi wajah gambar perbandingan. |
verifyImage |
Detail wajah untuk verifikasi. |
QualityForRecognition
Menunjukkan kualitas gambar untuk pengenalan.
Nama | Jenis | Deskripsi |
---|---|---|
high |
string |
Kualitas tinggi. |
low |
string |
Kualitas rendah. |
medium |
string |
Kualitas sedang. |