Face Recognition Operations - Verify Face To Face

Service:

Azure AI Services

API Version:

v1.1-preview.1

Verifikasi apakah dua wajah milik orang yang sama.

Catatan

• • Kualitas gambar wajah yang lebih tinggi berarti presisi identifikasi yang lebih baik. Harap pertimbangkan wajah berkualitas tinggi: ukuran depan, jernih, dan wajah adalah 200x200 piksel (100 piksel antar mata) atau lebih besar.
  • Untuk skenario yang sensitif terhadap akurasi, harap buat penilaian Anda sendiri.
  • 'recognitionModel' yang terkait dengan kedua wajah harus sama.

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
faceId1	True	string	FaceId dari satu wajah, berasal dari "Deteksi".
faceId2	True	string	FaceId wajah lain, berasal dari "Deteksi".

Respons

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

Verify Face to Face

Sample Request

HTTP

POST {endpoint}/face/v1.1-preview.1/verify

{
  "faceId1": "c5c24a82-6845-4031-9d5d-978df9175426",
  "faceId2": "3aa87e30-b380-48eb-ad9e-1aa54fc52bd3"
}

Sample Response

Status code:

200

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

Definisi

Nama	Deskripsi
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.
FaceErrorResponse	Respons yang berisi detail kesalahan.
VerificationResult	Verifikasi hasil.

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	FaceError	Objek kesalahan.

VerificationResult

Verifikasi hasil.

Nama	Jenis	Deskripsi
confidence	number	Angka menunjukkan keyakinan kesamaan apakah dua wajah milik orang yang sama, atau apakah wajah tersebut 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.