Face Recognition Operations - Verify From Person Group

Layanan:

Azure AI Services

Versi API:

v1.2

Verifikasi apakah wajah milik seseorang dalam Grup Orang.

Nota

• • Kualitas gambar wajah yang lebih tinggi berarti presisi identifikasi yang lebih baik. Harap pertimbangkan wajah berkualitas tinggi: ukuran frontal, clear, dan face adalah 200x200 piksel (100 piksel antar mata) atau lebih besar.
  • Untuk skenario yang sensitif terhadap akurasi, silakan buat penilaian Anda sendiri.
  • 'recognitionModel' yang terkait dengan wajah kueri harus sama dengan 'recognitionModel' yang digunakan oleh Grup Orang.

POST {endpoint}/face/{apiVersion}/verify

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).

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
faceId	True	string (uuid)	FaceId wajah, berasal dari "Deteksi".
personGroupId	True	string	Menggunakan personGroupId dan personId yang ada untuk memuat cepat orang tertentu. personGroupId dibuat di "Buat Grup Orang".
personId	True	string (uuid)	Tentukan orang tertentu dalam Grup Orang.

Respons

Nama	Jenis	Deskripsi
200 OK	VerificationResult	Panggilan yang berhasil mengembalikan hasil verifikasi.
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

Verify from PersonGroup

Permintaan sampel

HTTP

POST {endpoint}/face/v1.2/verify

{
  "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
  "personId": "815df99c-598f-4926-930a-a734b3fd651c",
  "personGroupId": "your_person_group"
}

Respon sampel

Kode status:

200

{
  "isIdentical": true,
  "confidence": 0.8
}

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.
VerificationResult	Verifikasi hasil.

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.

VerificationResult

Objek

Verifikasi hasil.

Nama	Jenis	Deskripsi
confidence	number (float) minimum: 0 maximum: 1	Angka menunjukkan keyakinan kesamaan apakah dua wajah milik orang yang sama, atau apakah wajah milik orang tersebut. Secara default, isIdentical diatur ke True jika keyakinan kesamaan lebih besar dari atau sama dengan 0,5. Ini berguna bagi pengguna tingkat lanjut untuk mengambil alih 'isIdentical' dan menyempurnakan hasilnya pada data mereka sendiri.
isIdentical	boolean	Benar jika kedua wajah tersebut milik orang yang sama atau wajah milik orang tersebut, jika tidak salah.