Liveness Session Operations - Create Liveness With Verify Session With Verify Image
Create sesi liveness baru dengan verifikasi. Berikan gambar verifikasi selama pembuatan sesi.
Sesi adalah yang terbaik untuk skenario perangkat klien di mana pengembang ingin mengotorisasi perangkat klien untuk hanya melakukan deteksi liveness tanpa memberikan akses penuh ke sumber daya mereka. Sesi yang dibuat memiliki rentang hidup terbatas dan hanya mengotorisasi klien untuk melakukan tindakan yang diinginkan sebelum akses kedaluwarsa.
Izin mencakup...
-
- Kemampuan untuk memanggil /detectLivenessWithVerify/singleModal hingga 3 percobaan ulang.
- Masa pakai token 10 menit.
Catatan
-
- Akses klien dapat dicabut dengan menghapus sesi menggunakan operasi Hapus Keakuratan Dengan Verifikasi Sesi.
- Untuk mengambil hasil, gunakan Dapatkan Keakuratan Dengan Sesi Verifikasi.
- Untuk mengaudit permintaan individual yang telah dibuat klien ke sumber daya Anda, gunakan Entri Audit Sesi List Liveness With Verify.
Opsi yang Direkomendasikan: VerifyImage disediakan selama pembuatan sesi.
POST {endpoint}/face/{apiVersion}/detectLivenessWithVerify/singleModal/sessions
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
Parameters
|
formData | True |
string |
Parameter untuk membuat sesi. |
Verify
|
formData | True |
file |
Aliran gambar untuk diverifikasi. Bidang header Content-Disposition untuk bagian ini harus memiliki nama file. |
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). |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
Panggilan yang berhasil membuat sesi untuk perangkat klien dan menyediakan token otorisasi untuk digunakan oleh aplikasi klien untuk tujuan dan waktu terbatas. |
|
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
Create LivenessWithVerify Session with VerifyImage
Permintaan sampel
POST {endpoint}/face/v1.1-preview.1/detectLivenessWithVerify/singleModal/sessions
Respon sampel
{
"sessionId": "b12e033e-bda7-4b83-a211-e721c661f30e",
"authToken": "eyJhbGciOiJFUzI1NiIsIm",
"verifyImage": {
"faceRectangle": {
"width": 78,
"height": 78,
"left": 394,
"top": 54
},
"qualityForRecognition": "high"
}
}
Definisi
Nama | Deskripsi |
---|---|
Create |
Respons sesi keaktivaan dengan memverifikasi pembuatan dengan memverifikasi gambar yang disediakan. |
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. |
Face |
Persegi panjang di mana wajah dapat ditemukan. |
Liveness |
Detail wajah untuk verifikasi. |
Quality |
Menunjukkan kualitas gambar untuk pengenalan. |
CreateLivenessWithVerifySessionResult
Respons sesi keaktivaan dengan memverifikasi pembuatan dengan memverifikasi gambar yang disediakan.
Nama | Jenis | Deskripsi |
---|---|---|
authToken |
string |
Token pembawa untuk menyediakan autentikasi untuk Vision SDK yang berjalan pada aplikasi klien. Token Pembawa ini memiliki izin terbatas untuk hanya melakukan tindakan yang diperlukan dan kedaluwarsa setelah waktu TTL. Ini juga dapat diaudit. |
sessionId |
string |
ID sesi unik dari sesi yang dibuat. Ini akan kedaluwarsa 48 jam setelah dibuat atau dapat dihapus lebih cepat menggunakan operasi HAPUS Sesi yang sesuai. |
verifyImage |
Detail wajah untuk verifikasi. |
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. |
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. |
LivenessWithVerifyImage
Detail wajah untuk verifikasi.
Nama | Jenis | Deskripsi |
---|---|---|
faceRectangle |
Wilayah wajah tempat klasifikasi gambar perbandingan dibuat. |
|
qualityForRecognition |
Kualitas gambar wajah untuk pengenalan. |
QualityForRecognition
Menunjukkan kualitas gambar untuk pengenalan.
Nama | Jenis | Deskripsi |
---|---|---|
high |
string |
Kualitas tinggi. |
low |
string |
Kualitas rendah. |
medium |
string |
Kualitas sedang. |