Person Group Operations - Get Large Person Group
Ambil informasi Grup Orang Besar, termasuk namanya, userData, dan recognitionModel. API ini hanya mengembalikan informasi Grup Orang Besar, gunakan "Dapatkan Orang Grup Orang Besar" sebagai gantinya untuk mengambil informasi orang di bawah Grup Orang Besar.
GET {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}
GET {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}?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). |
large
|
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 Besar. |
|
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 LargePersonGroup
Sample Request
GET {endpoint}/face/v1.1-preview.1/largepersongroups/your_large_person_group_id?returnRecognitionModel=True
Sample Response
{
"name": "your_large_person_group_name",
"userData": "your_user_data",
"recognitionModel": "recognition_01",
"largePersonGroupId": "your_large_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. |
Large |
Kontainer data orang yang diunggah, termasuk fitur pengenalan wajah, dan hingga 1.000.000 orang. |
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. |
LargePersonGroup
Kontainer data orang yang diunggah, termasuk fitur pengenalan wajah, dan hingga 1.000.000 orang.
Nama | Jenis | Deskripsi |
---|---|---|
largePersonGroupId |
string |
ID kontainer. |
name |
string |
Nama yang ditentukan pengguna, panjang maksimum adalah 128. |
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. |