Face Recognition Operations - Find Similar From Large Face List

Layanan:

Azure AI Services

Versi API:

v1.2

FaceId wajah kueri yang diberikan, untuk mencari wajah yang terlihat mirip dari Daftar Wajah Besar. 'largeFaceListId' dibuat oleh Buat Daftar Wajah Besar.
Bergantung pada input daftar wajah serupa yang dikembalikan berisi faceIds atau persistedFaceIds yang diberi peringkat oleh kesamaan.

Temukan yang serupa memiliki dua mode kerja, "matchPerson" dan "matchFace". "matchPerson" adalah mode default yang mencoba menemukan wajah orang yang sama dengan mungkin dengan menggunakan ambang batas orang yang sama internal. Hal ini berguna untuk menemukan foto lain orang yang dikenal. Perhatikan bahwa daftar kosong akan dikembalikan jika tidak ada wajah yang melewati ambang batas internal. Mode "matchFace" mengabaikan ambang batas orang yang sama dan tetap mengembalikan wajah serupa peringkat, bahkan kesamaannya rendah. Ini dapat digunakan dalam kasus-kasus seperti mencari wajah yang tampak selebriti.

'recognitionModel' yang terkait dengan faceId kueri harus sama dengan 'recognitionModel' yang digunakan oleh Daftar Wajah Besar target.

POST {endpoint}/face/{apiVersion}/findsimilars

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 dari wajah kueri. Pengguna perlu memanggil "Deteksi" terlebih dahulu untuk mendapatkan faceId yang valid. Perhatikan bahwa faceId ini tidak bertahan dan akan kedaluwarsa 24 jam setelah panggilan deteksi.
largeFaceListId	True	string	Daftar Wajah Besar kandidat unik yang ditentukan pengguna yang ada, dibuat di "Buat Daftar Wajah Besar". Daftar Wajah Besar berisi sekumpulan persistedFaceIds yang bertahan dan tidak akan pernah kedaluwarsa.
maxNumOfCandidatesReturned		integer (int32) minimum: 1 maximum: 1000	Jumlah wajah serupa teratas yang dikembalikan. Rentang yang valid adalah [1, 1000]. Nilai defaultnya adalah 20.
mode		FindSimilarMatchMode	Mode pencarian wajah serupa. Ini bisa menjadi 'matchPerson' atau 'matchFace'. Nilai defaultnya adalah 'matchPerson'.

Respons

Nama	Jenis	Deskripsi
200 OK	FindSimilarResult[]	Panggilan yang berhasil mengembalikan array wajah yang paling mirip yang diwakili dalam faceId jika parameter input adalah faceIds atau persistedFaceId jika parameter input adalah faceListId atau largeFaceListId.
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

Find Similar from LargeFaceList

Permintaan sampel

HTTP

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

{
  "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
  "maxNumOfCandidatesReturned": 3,
  "mode": "matchPerson",
  "largeFaceListId": "your_large_face_list_id"
}

Respon sampel

Kode status:

200

[
  {
    "confidence": 0.8,
    "persistedFaceId": "015839fb-fbd9-4f79-ace9-7675fc2f1dd9"
  }
]

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.
FindSimilarResult	Isi respons untuk menemukan operasi wajah yang serupa.

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.

FindSimilarResult

Objek

Isi respons untuk menemukan operasi wajah yang serupa.

Nama	Jenis	Deskripsi
confidence	number (float) minimum: 0 maximum: 1	Nilai keyakinan kandidat. Semakin tinggi keyakinan, semakin mirip. Rentang antara [0,1].
faceId	string (uuid)	faceId wajah kandidat saat ditemukan oleh faceIds. faceId dibuat oleh "Deteksi" dan akan kedaluwarsa 24 jam setelah panggilan deteksi.
persistedFaceId	string (uuid)	persistedFaceId dari wajah kandidat saat ditemukan oleh faceListId atau largeFaceListId. persistedFaceId dalam daftar wajah/daftar wajah besar dipertahankan dan tidak akan kedaluwarsa.