Bagikan melalui


Face List - Add Face From Stream

Tambahkan wajah ke daftar wajah tertentu, hingga 1.000 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 FaceList - Hapus Wajah atau FaceList - Hapus dipanggil.
Catatan persistedFaceId berbeda dari faceId yang dihasilkan oleh Face - Detect.

  • Kualitas gambar wajah yang lebih tinggi berarti deteksi dan 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.
  • 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 daftar wajah yang sama diproses secara berurutan dan ke/dari daftar wajah yang berbeda 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, lihat Cara menentukan model deteksi.
POST {Endpoint}/face/v1.0/facelists/{faceListId}/persistedfaces
POST {Endpoint}/face/v1.0/facelists/{faceListId}/persistedfaces?overload=stream&userData={userData}&targetFace={targetFace}&detectionModel={detectionModel}

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
Endpoint
path True

string

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

faceListId
path True

string

Id mereferensikan daftar wajah tertentu.

Pola regex: ^[a-z0-9-_]+$

detectionModel
query

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.

targetFace
query

integer[]

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

Media Types: "application/octet-stream"

Nama Diperlukan Jenis Deskripsi
Ocp-Apim-Subscription-Key True

string

Isi Permintaan

Media Types: "application/octet-stream"

Nama Jenis Deskripsi
Image

object

Aliran gambar.

Respons

Nama Jenis Deskripsi
200 OK

PersistedFace

Panggilan yang berhasil mengembalikan persistedFaceId baru.

Other Status Codes

APIError

Respons kesalahan.

Keamanan

Ocp-Apim-Subscription-Key

Jenis: apiKey
Dalam: header

Contoh

Add face to face list from stream example

Permintaan sampel

POST {Endpoint}/face/v1.0/facelists/sample_face_list/persistedfaces?overload=stream&userData={Customized user data}&targetFace=10,10,100,100&detectionModel=detection_01


"{Image stream in base 64 encoded format}"

Respon sampel

{
  "persistedFaceId": "B8D802CF-DD8F-4E61-B15C-9E6C5844CCBA"
}

Definisi

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

PersistedFace

Objek PersonFace.

APIError

Informasi kesalahan yang dikembalikan oleh API

Nama Jenis Deskripsi
error

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.

Nama Jenis Deskripsi
detection_01

string

detection_02

string

detection_03

string

Error

Isi kesalahan.

Nama Jenis Deskripsi
code

string

message

string

PersistedFace

Objek PersonFace.

Nama Jenis Deskripsi
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.