Person Group Operations - Get Person Group
Ambil nama Grup Orang, userData, dan recognitionModel. Untuk mendapatkan informasi orang di bawah personGroup ini, gunakan "Dapatkan Orang Grup".
GET {endpoint}/face/{apiVersion}/persongroups/{personGroupId}
GET {endpoint}/face/{apiVersion}/persongroups/{personGroupId}?returnRecognitionModel={returnRecognitionModel}
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). |
person
|
path | True |
string |
ID kontainer. Regex pattern: |
return
|
query |
boolean |
Mengembalikan 'recognitionModel' atau tidak. Nilai defaultnya adalah false. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
Panggilan yang berhasil mengembalikan informasi Grup Orang. |
|
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
Get PersonGroup
Sample Request
GET {endpoint}/face/v1.1-preview.1/persongroups/your_person_group_id?returnRecognitionModel=True
Sample Response
{
"name": "your_person_group_name",
"userData": "your_user_data",
"recognitionModel": "recognition_01",
"personGroupId": "your_person_group_id"
}
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. |
Person |
Kontainer data orang yang diunggah, termasuk fitur pengenalan wajah, dan hingga 10.000 orang. Untuk menangani masalah identifikasi wajah skala yang lebih besar, pertimbangkan untuk menggunakan Grup Orang Besar. |
Recognition |
Model pengenalan untuk wajah. |
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. |
PersonGroup
Kontainer data orang yang diunggah, termasuk fitur pengenalan wajah, dan hingga 10.000 orang. Untuk menangani masalah identifikasi wajah skala yang lebih besar, pertimbangkan untuk menggunakan Grup Orang Besar.
Nama | Jenis | Deskripsi |
---|---|---|
name |
string |
Nama yang ditentukan pengguna, panjang maksimum adalah 128. |
personGroupId |
string |
ID kontainer. |
recognitionModel |
Nama model pengenalan. Model pengenalan digunakan saat fitur wajah diekstrak dan dikaitkan dengan faceIds yang terdeteksi. |
|
userData |
string |
Data yang ditentukan pengguna opsional. Panjang tidak boleh melebihi 16K. |
RecognitionModel
Model pengenalan untuk wajah.
Nama | Jenis | Deskripsi |
---|---|---|
recognition_01 |
string |
Model pengenalan default untuk "Deteksi". Semua faceId yang dibuat sebelum 2019 Maret diikat dengan model pengenalan ini. |
recognition_02 |
string |
Model pengenalan dirilis pada bulan Maret 2019. |
recognition_03 |
string |
Model pengenalan dirilis pada bulan Mei 2020. |
recognition_04 |
string |
Model pengenalan dirilis pada februari 2021. Disarankan untuk menggunakan model pengenalan ini untuk akurasi pengenalan yang lebih baik. |