Bagikan melalui

Face Recognition Operations - Verify Face To Face

  • Referensi
Layanan:
Azure AI Services
Versi API:
v1.2-preview.1

Verifikasi apakah dua wajah milik orang yang sama.

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 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 dari wajah lain, berasal dari "Deteksi".

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 Face to Face

Permintaan sampel

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

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

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

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