Person Group Operations - Create Large Person Group
Create Grup Orang Besar baru dengan largePersonGroupId, nama, userData opsional, dan recognitionModel yang ditentukan pengguna.
Grup Orang Besar adalah kontainer yang menyimpan data orang yang diunggah, termasuk fitur pengenalan wajah. Ini dapat menampung hingga 1.000.000 entitas.
Setelah pembuatan, gunakan "Create Orang Grup Orang Besar" untuk menambahkan orang ke dalam grup, dan panggil "Latih Grup Orang Besar" untuk menyiapkan grup ini untuk "Identifikasi Dari Grup Orang Besar".
Tidak ada gambar yang akan disimpan. Hanya fitur wajah orang yang diekstrak dan userData yang akan disimpan di server hingga "Hapus Orang Grup Orang Besar" atau "Hapus Grup Orang Besar" yang dipanggil.
'recognitionModel' harus ditentukan untuk dikaitkan dengan Grup Orang Besar 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 Besar yang ada akan menggunakan model pengenalan yang sudah terkait dengan koleksi. Fitur wajah yang ada di Grup Orang Besar tidak dapat diperbarui ke fitur yang diekstrak oleh versi model pengenalan lain.
Catatan
-
- Kuota langganan tingkat gratis: 1.000 Grup Orang Besar.
- Kuota langganan tingkat S0: 1.000.000 Grup Orang Besar.
PUT {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
api
|
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). |
large
|
path | True |
string |
ID kontainer. Regex pattern: |
Isi Permintaan
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
name | True |
string |
Nama yang ditentukan pengguna, panjang maksimum adalah 128. |
recognitionModel |
Recognition |
'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 |
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
Create LargePersonGroup
Sample Request
PUT {endpoint}/face/v1.1-preview.1/largepersongroups/your_large_person_group_id
{
"name": "your_large_person_group_name",
"userData": "your_user_data",
"recognitionModel": "recognition_01"
}
Sample Response
Definisi
Nama | Deskripsi |
---|---|
Face |
Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Layanan Wajah, silakan lihat tautan berikut: https://aka.ms/face-error-codes-and-messages. |
Face |
Respons yang berisi detail kesalahan. |
FaceError
Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Layanan Wajah, 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 |
Objek kesalahan. |