Liveness Session Operations - Get Liveness Session Result

Layanan:: Azure AI Services

Versi API:: v1.2

Dapatkan hasil sesi dari detectLiveness/singleModal call.

GET {endpoint}/face/{apiVersion}/detectLiveness-sessions/{sessionId}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
apiVersion	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).
sessionId	path	True	string	ID unik untuk mereferensikan sesi ini.

Respons

Nama	Jenis	Deskripsi
200 OK	LivenessSession	Permintaan telah berhasil.
Other Status Codes	FaceErrorResponse	Respons kesalahan tak terduga. Header x-ms-error-code: string

Nama

Jenis

Deskripsi

200 OK

LivenessSession

Permintaan telah berhasil.

Other Status Codes

FaceErrorResponse

Respons kesalahan tak 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 LivenessSession Result

Permintaan sampel

HTTP

GET {endpoint}/face/v1.2/detectLiveness-sessions/b12e033e-bda7-4b83-a211-e721c661f30e

Respon sampel

Kode status:: 200

{
  "sessionId": "b12e033e-bda7-4b83-a211-e721c661f30e",
  "authToken": "eyJhbGciOiJFUzI1NiIsIm",
  "status": "NotStarted",
  "modelVersion": "2024-11-15",
  "results": {
    "attempts": [
      {
        "attemptId": 2,
        "attemptStatus": "Succeeded",
        "result": {
          "livenessDecision": "realface",
          "targets": {
            "color": {
              "faceRectangle": {
                "top": 669,
                "left": 203,
                "width": 646,
                "height": 724
              }
            }
          },
          "digest": "B0A803BB7B26F3C8F29CD36030F8E63ED3FAF955FEEF8E01C88AB8FD89CCF761",
          "sessionImageId": "Ae3PVWlXAmVAnXgkAFt1QSjGUWONKzWiSr2iPh9p9G4I"
        }
      },
      {
        "attemptId": 1,
        "attemptStatus": "Failed",
        "error": {
          "code": "FaceWithMaskDetected",
          "message": "Mask detected on face image.",
          "targets": {
            "color": {
              "faceRectangle": {
                "top": 669,
                "left": 203,
                "width": 646,
                "height": 724
              }
            }
          }
        }
      }
    ]
  }
}

Definisi

Nama	Deskripsi
FaceError	Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Layanan Wajah, lihat tautan berikut: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Respons yang berisi detail kesalahan.
FaceRectangle	Persegi panjang di mana wajah dapat ditemukan.
LivenessColorDecisionTarget	Target dari gambar warna yang digunakan untuk klasifikasi liveness.
LivenessDecision	Hasil klasifikasi keakuratan.
LivenessDecisionTargets	Target yang digunakan untuk klasifikasi liveness.
LivenessError	Kesalahan klasifikasi liveness.
LivenessModel	Versi model yang digunakan untuk klasifikasi liveness.
LivenessResult	Hasil klasifikasi liveness.
LivenessSession	Hasil sesi mendeteksi keakuratan.
LivenessSessionAttempt	Upaya sesi liveness.
LivenessSessionResults	Hasil sesi liveness.
OperationState	Status sesi saat ini.

FaceError

Objek

Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Layanan Wajah, lihat tautan berikut: https://aka.ms/face-error-codes-and-messages.

Nama	Jenis	Deskripsi
code	string	Salah satu sekumpulan kode kesalahan yang ditentukan server.
message	string	Representasi kesalahan yang dapat dibaca manusia.

FaceErrorResponse

Objek

Respons yang berisi detail kesalahan.

Nama	Jenis	Deskripsi
error	FaceError	Objek kesalahan.

FaceRectangle

Objek

Persegi panjang di mana wajah dapat ditemukan.

Nama	Jenis	Deskripsi
height	integer (int32)	Tinggi persegi panjang, dalam piksel.
left	integer (int32)	Jarak dari tepi kiri jika gambar ke tepi kiri persegi panjang, dalam piksel.
top	integer (int32)	Jarak dari tepi atas jika gambar ke tepi atas persegi panjang, dalam piksel.
width	integer (int32)	Lebar persegi panjang, dalam piksel.

LivenessColorDecisionTarget

Objek

Target dari gambar warna yang digunakan untuk klasifikasi liveness.

Nama	Jenis	Deskripsi
faceRectangle	FaceRectangle	Wilayah wajah tempat klasifikasi liveness dibuat.

LivenessDecision

Enumeration

Hasil klasifikasi keakuratan.

Nilai	Deskripsi
uncertain	Algoritma tidak dapat mengklasifikasikan wajah target sebagai nyata atau spoof.
realface	Algoritma telah mengklasifikasikan wajah target sebagai nyata.
spoofface	Algoritma telah mengklasifikasikan wajah target sebagai spoof.

LivenessDecisionTargets

Objek

Target yang digunakan untuk klasifikasi liveness.

Nama	Jenis	Deskripsi
color	LivenessColorDecisionTarget	Target dari gambar warna yang digunakan untuk klasifikasi liveness.

LivenessError

Objek

Kesalahan klasifikasi liveness.

Nama	Jenis	Deskripsi
code	string	Kode kesalahan.
message	string	Pesan kesalahan.
targets	LivenessDecisionTargets	Target yang digunakan untuk klasifikasi liveness.

LivenessModel

Enumeration

Versi model yang digunakan untuk klasifikasi liveness.

Nilai	Deskripsi
2024-11-15

LivenessResult

Objek

Hasil klasifikasi liveness.

Nama	Jenis	Deskripsi
digest	string	Server menghitung hash untuk permintaan ini. Jika klien melaporkan hash 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 cara memanfaatkan nilai ini untuk mengamankan solusi menyeluruh Anda.
livenessDecision	LivenessDecision	Klasifikasi liveness untuk wajah target.
sessionImageId	string	ID gambar permintaan sesi.
targets	LivenessDecisionTargets	Target yang digunakan untuk klasifikasi liveness.