Bagikan melalui


Face Recognition Operations - Identify From Large Person Group

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

Catatan

    • 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 depan, jernih, dan wajah 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/Grup Orang Besar.
    • FaceId 'recognitionModel' yang terkait dengan wajah kueri' harus sama dengan 'recognitionModel' yang digunakan oleh Grup Orang target atau Grup Orang Besar.
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[]

Array wajah kueri faceIds, dibuat oleh "Deteksi". Masing-masing wajah diidentifikasi secara independen. Jumlah faceIds yang valid adalah antara [1, 10].

largePersonGroupId True

string

largePersonGroupId dari target Grup Orang Besar, dibuat oleh "Create Grup Orang Besar". Parameter personGroupId dan largePersonGroupId tidak boleh disediakan secara bersamaan.

confidenceThreshold

number

Ambang keyakinan identifikasi yang disesuaikan, dalam kisaran [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 yang bekerja pada data lain dan setelah pembaruan algoritma.

maxNumOfCandidatesReturned

integer

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

Identify from LargePersonGroup

Sample Request

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

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

Sample Response

[
  {
    "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 Face Service, silakan 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 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.

IdentificationCandidate

Kandidat untuk mengidentifikasi panggilan.

Nama Jenis Deskripsi
confidence

number

Nilai keyakinan kandidat. Semakin tinggi kepercayaan diri, semakin mirip. Rentang antara [0,1].

personId

string

personId orang kandidat.

IdentificationResult

Identifikasi hasil.

Nama Jenis Deskripsi
candidates

IdentificationCandidate[]

Kandidat orang yang diidentifikasi untuk wajah tersebut (diberi peringkat berdasarkan keyakinan). Ukuran array tidak boleh lebih besar dari input maxNumOfCandidatesReturned. Jika tidak ada orang yang diidentifikasi, akan mengembalikan array kosong.

faceId

string

faceId wajah kueri.