Face Recognition Operations - Identify From Person Group

Layanan:

Azure AI Services

Versi API:

v1.2

Identifikasi 1-ke-banyak untuk menemukan kecocokan terdekat dari wajah orang kueri tertentu dari Grup Orang.
Untuk setiap wajah dalam array faceIds, Face Identifi akan menghitung kesamaan antara wajah kueri dan semua wajah dalam Grup Orang (diberikan oleh personGroupId), dan mengembalikan orang kandidat untuk wajah tersebut yang diberi peringkat oleh keyakinan kesamaan. Grup Orang harus dilatih untuk membuatnya siap untuk identifikasi. Lihat selengkapnya di "Latih Grup Orang".

Nota

• • Algoritma memungkinkan lebih dari satu wajah diidentifikasi secara independen pada permintaan yang sama, tetapi tidak lebih dari 10 wajah.
  • Setiap orang bisa memiliki lebih dari satu wajah, tetapi tidak lebih dari 248 wajah.
  • 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.
  • Jumlah kandidat yang dikembalikan dibatasi oleh maxNumOfCandidatesReturned dan confidenceThreshold. Jika tidak ada orang yang diidentifikasi, kandidat yang dikembalikan akan menjadi array kosong.
  • Coba "Temukan Serupa" saat Anda perlu menemukan wajah serupa dari Daftar Wajah/Daftar Wajah Besar, bukan Grup Orang.
  • FaceId 'recognitionModel' yang terkait dengan wajah kueri harus sama dengan 'recognitionModel' yang digunakan oleh Grup Orang target.

POST {endpoint}/face/{apiVersion}/identify

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
faceIds	True	string[] (uuid)	Array wajah kueri faceIds, dibuat oleh "Deteksi". Masing-masing wajah diidentifikasi secara independen. Jumlah faceIds yang valid antara [1, 10].
personGroupId	True	string	personGroupId dari Grup Orang target, dibuat oleh "Buat Grup Orang". Parameter personGroupId dan largePersonGroupId tidak boleh disediakan secara bersamaan.
confidenceThreshold		number (float) minimum: 0 maximum: 1	Ambang keyakinan identifikasi yang disesuaikan, dalam rentang [0, 1]. Pengguna tingkat lanjut dapat mengubah nilai ini untuk mengambil alih ambang internal default untuk presisi yang lebih baik pada data skenario mereka. Perhatikan bahwa tidak ada jaminan nilai ambang ini bekerja pada data lain dan setelah pembaruan algoritma.
maxNumOfCandidatesReturned		integer (int32) minimum: 1 maximum: 100	Rentang maxNumOfCandidatesReturned adalah antara 1 dan 100. Nilai defaultnya adalah 10.

Respons

Nama	Jenis	Deskripsi
200 OK	IdentificationResult[]	Panggilan yang berhasil mengembalikan orang kandidat yang diidentifikasi untuk setiap wajah kueri.
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

Identify from PersonGroup

Permintaan sampel

HTTP

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

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "personGroupId": "your_person_group_id",
  "maxNumOfCandidatesReturned": 9,
  "confidenceThreshold": 0.7
}

Respon sampel

Kode status:

200

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "candidates": [
      {
        "personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
        "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.
IdentificationCandidate	Kandidat untuk mengidentifikasi panggilan.
IdentificationResult	Identifikasi 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.

IdentificationCandidate

Objek

Kandidat untuk mengidentifikasi panggilan.

Nama	Jenis	Deskripsi
confidence	number (float) minimum: 0 maximum: 1	Nilai keyakinan kandidat. Semakin tinggi keyakinan, semakin mirip. Rentang antara [0,1].
personId	string (uuid)	personId orang kandidat.

IdentificationResult

Objek

Identifikasi hasil.

Nama	Jenis	Deskripsi
candidates	IdentificationCandidate[]	Kandidat orang yang diidentifikasi untuk wajah tersebut (diberi peringkat dengan keyakinan). Ukuran array tidak boleh lebih besar dari input maxNumOfCandidatesReturned. Jika tidak ada orang yang diidentifikasi, akan mengembalikan array kosong.
faceId	string (uuid)	faceId dari wajah kueri.