Liveness Session Operations - Create Liveness With Verify Session With Verify Image

Service:

Azure AI Services

API Version:

v1.1-preview.1

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.
VerifyImage	formData	True	file	Aliran gambar untuk diverifikasi. Bidang header Content-Disposition untuk bagian ini harus memiliki nama file.
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).

Respons

Nama	Jenis	Deskripsi
200 OK	CreateLivenessWithVerifySessionResult	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	FaceErrorResponse	Respons kesalahan yang tidak terduga. Headers x-ms-error-code: string

Keamanan

Ocp-Apim-Subscription-Key

Kunci rahasia untuk langganan Azure AI Face Anda.

Type: apiKey
In: header

AADToken

Alur OAuth2 Azure Active Directory

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

Nama	Deskripsi
https://cognitiveservices.azure.com/.default

Contoh

Create LivenessWithVerify Session with VerifyImage

Sample Request

HTTP

POST {endpoint}/face/v1.1-preview.1/detectLivenessWithVerify/singleModal/sessions

Sample Response

Status code:

200

{
  "sessionId": "b12e033e-bda7-4b83-a211-e721c661f30e",
  "authToken": "eyJhbGciOiJFUzI1NiIsIm",
  "verifyImage": {
    "faceRectangle": {
      "width": 78,
      "height": 78,
      "left": 394,
      "top": 54
    },
    "qualityForRecognition": "high"
  }
}

Definisi

Nama	Deskripsi
CreateLivenessWithVerifySessionResult	Respons sesi keaktivaan dengan memverifikasi pembuatan dengan memverifikasi gambar yang disediakan.
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.
FaceErrorResponse	Respons yang berisi detail kesalahan.
FaceRectangle	Persegi panjang di mana wajah dapat ditemukan.
LivenessWithVerifyImage	Detail wajah untuk verifikasi.
QualityForRecognition	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	LivenessWithVerifyImage	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	FaceError	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	FaceRectangle	Wilayah wajah tempat klasifikasi gambar perbandingan dibuat.
qualityForRecognition	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.