Person Group Operations - Create Person Group

Layanan:

Azure AI Services

Versi API:

v1.2-preview.1

Buat Grup Orang baru dengan personGroupId tertentu, nama, userData yang disediakan pengguna dan recognitionModel.
Grup Orang adalah kontainer yang menyimpan data orang yang diunggah, termasuk fitur pengenalan wajah.

Setelah pembuatan, gunakan "Buat Orang Grup Orang" untuk menambahkan orang ke dalam grup, lalu panggil "Latih Grup Orang" untuk menyiapkan grup ini untuk "Identifikasi Dari Grup Orang".

Tidak ada gambar yang akan disimpan. Hanya fitur wajah orang yang diekstrak dan userData yang akan disimpan di server hingga "Hapus Orang Grup Orang" atau "Hapus Grup Orang" dipanggil.

'recognitionModel' harus ditentukan untuk dikaitkan dengan Grup Orang ini. Nilai default untuk 'recognitionModel' adalah 'recognition_01', jika model terbaru diperlukan, tentukan model yang Anda butuhkan secara eksplisit dalam parameter ini. Wajah baru yang ditambahkan ke Grup Orang yang ada akan menggunakan model pengenalan yang sudah terkait dengan koleksi. Fitur wajah yang ada di Grup Orang tidak dapat diperbarui ke fitur yang diekstrak oleh versi model pengenalan lain.

Nota

• • Kuota langganan tingkat gratis: 1.000 Grup Orang. Masing-masing memiliki hingga 1.000 orang.
  • Kuota langganan tingkat S0: 1.000.000 Grup Orang. Masing-masing memiliki hingga 10.000 orang.
  • untuk menangani masalah identifikasi wajah skala yang lebih besar, harap pertimbangkan untuk menggunakan Grup Orang Besar.

PUT {endpoint}/face/{apiVersion}/persongroups/{personGroupId}

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).
personGroupId	path	True	string	ID kontainer. Pola regex: ^[a-z0-9-_]+$

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
name	True	string	Nama yang ditentukan pengguna, panjang maksimum adalah 128.
recognitionModel		RecognitionModel	'recognitionModel' yang terkait dengan daftar wajah ini. Nilai 'recognitionModel' yang didukung termasuk 'recognition_01', 'recognition_02, 'recognition_03', dan 'recognition_04'. Nilai defaultnya adalah 'recognition_01'. 'recognition_04' direkomendasikan karena akurasinya ditingkatkan pada wajah yang mengenakan masker dibandingkan dengan 'recognition_03', dan akurasi keseluruhannya ditingkatkan dibandingkan dengan 'recognition_01' dan 'recognition_02'.
userData		string	Data yang ditentukan pengguna opsional. Panjang tidak boleh melebihi 16K.

Respons

Nama	Jenis	Deskripsi
200 OK		Permintaan telah berhasil.
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

Create PersonGroup

Permintaan sampel

HTTP

PUT {endpoint}/face/v1.2-preview.1/persongroups/your_person_group_id

{
  "name": "your_person_group_name",
  "userData": "your_user_data",
  "recognitionModel": "recognition_01"
}

Respon sampel

Kode status:

200

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.

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.

Nama	Jenis	Deskripsi
code	string	Salah satu sekumpulan 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.