Large Person Group Person - Add Face From Url

Tambahkan wajah ke seseorang ke dalam grup orang besar untuk identifikasi atau verifikasi wajah. Untuk menangani gambar berisi beberapa wajah, wajah input dapat ditentukan sebagai gambar dengan persegi panjang targetFace. Ini mengembalikan persistedFaceId yang mewakili wajah yang ditambahkan. Tidak ada gambar yang akan disimpan. Hanya fitur wajah yang diekstrak yang akan disimpan di server hingga LargePersonGroup PersonFace - Delete, LargePersonGroup Person - Delete atau LargePersonGroup - Delete dipanggil.
Catatan persistedFaceId berbeda dari faceId yang dihasilkan oleh Face - Detect.

  • Kualitas gambar wajah yang lebih tinggi berarti presisi pengenalan yang lebih baik. Harap pertimbangkan wajah berkualitas tinggi: ukuran depan, jernih, dan wajah adalah 200x200 piksel (100 piksel antar mata) atau lebih besar.
  • Setiap entri orang dapat menampung hingga 248 wajah.
  • Format JPEG, PNG, GIF (bingkai pertama), dan BMP didukung. Ukuran file gambar yang diizinkan adalah dari 1KB hingga 6MB.
  • Persegi panjang "targetFace" harus berisi satu wajah. Nol atau beberapa wajah akan dianggap sebagai kesalahan. Jika persegi panjang "targetFace" yang disediakan tidak dikembalikan dari Face - Detect, tidak ada jaminan untuk mendeteksi dan menambahkan wajah dengan sukses.
  • Ukuran wajah yang tidak dapat dideteksi (36x36 - 4096x4096 piksel), pose kepala besar, atau oklusi besar akan menyebabkan kegagalan.
  • Menambahkan/menghapus wajah ke/dari orang yang sama akan diproses secara berurutan. Menambahkan/menghapus wajah ke/dari orang yang berbeda diproses secara paralel.
  • Ukuran wajah minimum yang dapat dideteksi adalah 36x36 piksel dalam gambar yang tidak lebih besar dari 1920x1080 piksel. Gambar dengan dimensi yang lebih tinggi dari 1920x1080 piksel akan membutuhkan ukuran wajah minimum yang lebih besar secara proporsional.
  • Nilai 'detectionModel' yang berbeda dapat disediakan. Untuk menggunakan dan membandingkan model deteksi yang berbeda, silakan lihat Cara menentukan model deteksi
POST {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces
POST {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces?userData={userData}&targetFace={targetFace}&detectionModel={detectionModel}

Parameter URI

Name In Required Type Description
Endpoint
path True
  • string

Titik akhir Cognitive Services yang didukung (protokol dan nama host, misalnya: https://westus.api.cognitive.microsoft.com).

largePersonGroupId
path True
  • string

Id yang mereferensikan grup orang besar tertentu.

Regex pattern: ^[a-z0-9-_]+$

personId
path True
  • string
uuid

Id yang merujuk pada orang tertentu.

detectionModel
query

Nama model deteksi. Model deteksi digunakan untuk mendeteksi wajah dalam gambar yang dikirimkan. Nama model deteksi dapat disediakan saat melakukan Face - Detect atau (Large)FaceList - Tambahkan Wajah atau (Besar)PersonGroup - Tambahkan Wajah. Nilai defaultnya adalah 'detection_01', jika model lain diperlukan, tentukan secara eksplisit.

targetFace
query
  • array

Persegi panjang wajah untuk menentukan wajah target yang akan ditambahkan ke seseorang dalam format "targetFace=left,top,width,height". Misalnya, "targetFace=10,10,100,100". Jika ada lebih dari satu wajah dalam gambar, targetFace diperlukan untuk menentukan wajah mana yang akan ditambahkan. Tidak ada targetFace berarti hanya ada satu wajah yang terdeteksi di seluruh gambar.

userData
query
  • string

Data yang ditentukan pengguna tentang wajah untuk tujuan apa pun. Panjang maksimum adalah 1KB.

Header Permintaan

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string

Isi Permintaan

Name Required Type Description
url True
  • string

URL gambar yang dapat dijangkau secara publik

Respons

Name Type Description
200 OK

Panggilan yang berhasil mengembalikan persistedFaceId baru.

Other Status Codes

Respons kesalahan.

Keamanan

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Contoh

Add Person face example

Sample Request

POST {Endpoint}/face/v1.0/largepersongroups/abc/persons/4caa25ee-3bc6-4e88-adf8-12455ce7aab0/persistedfaces?userData={customized User data}&targetFace=10,10,100,100&detectionModel=detection_01


{
  "url": "{Image Url here}"
}

Sample Response

{
  "persistedFaceId": "6e04c175-219e-42a2-9d26-0e7b790e1ef4"
}

Definisi

APIError

Informasi kesalahan yang dikembalikan oleh API

DetectionModel

Nama model deteksi. Model deteksi digunakan untuk mendeteksi wajah dalam gambar yang dikirimkan. Nama model deteksi dapat disediakan saat melakukan Face - Detect atau (Large)FaceList - Tambahkan Wajah atau (Besar)PersonGroup - Tambahkan Wajah. Nilai defaultnya adalah 'detection_01', jika model lain diperlukan, tentukan secara eksplisit.

Error

Isi kesalahan.

ImageUrl
PersistedFace

Objek PersonFace.

APIError

Informasi kesalahan yang dikembalikan oleh API

Name Type Description
error

Isi kesalahan.

DetectionModel

Nama model deteksi. Model deteksi digunakan untuk mendeteksi wajah dalam gambar yang dikirimkan. Nama model deteksi dapat disediakan saat melakukan Face - Detect atau (Large)FaceList - Tambahkan Wajah atau (Besar)PersonGroup - Tambahkan Wajah. Nilai defaultnya adalah 'detection_01', jika model lain diperlukan, tentukan secara eksplisit.

Name Type Description
detection_01
  • string
detection_02
  • string
detection_03
  • string

Error

Isi kesalahan.

Name Type Description
code
  • string
message
  • string

ImageUrl

Name Type Description
url
  • string

URL gambar yang dapat dijangkau secara publik

PersistedFace

Objek PersonFace.

Name Type Description
persistedFaceId
  • string

PersistedFaceId dari wajah target, yang bertahan dan tidak akan kedaluwarsa. Berbeda dari faceId yang dibuat oleh Face - Detect dan akan kedaluwarsa pada waktu yang ditentukan oleh faceIdTimeToLive setelah panggilan deteksi.

userData
  • string

Data yang disediakan pengguna yang dilampirkan ke wajah. Batas ukurannya adalah 1KB.