Face List Operations - Get Large Face Lists
Mencantumkan informasi Large Face Lists tentang largeFaceListId, nama, userData, dan recognitionModel.
Untuk mendapatkan informasi wajah di dalam largeFaceList, gunakan "Dapatkan Wajah Daftar Wajah Besar".
Lists Wajah Besar disimpan dalam urutan alfabet largeFaceListId.
-
- Parameter "start" (string, opsional) menentukan nilai ID dari mana entri yang dikembalikan akan memiliki ID yang lebih besar berdasarkan perbandingan string. Pengaturan "start" ke nilai kosong menunjukkan bahwa entri harus dikembalikan mulai dari item pertama.
- Parameter "atas" (int, opsional) menentukan jumlah maksimum entri yang akan dikembalikan, dengan batas hingga 1000 entri per panggilan. Untuk mengambil entri tambahan di luar batas ini, tentukan "mulai" dengan personId entri terakhir yang dikembalikan dalam panggilan saat ini.
Tip
- Misalnya, ada total 5 item dengan ID mereka: "itemId1", ..., "itemId5".
- "start=&top=" akan mengembalikan 5 item.
- "start=&top=2" akan mengembalikan "itemId1", "itemId2".
- "start=itemId2&top=3" akan mengembalikan "itemId3", "itemId4", "itemId5".
GET {endpoint}/face/{apiVersion}/largefacelists
GET {endpoint}/face/{apiVersion}/largefacelists?start={start}&top={top}&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). |
return
|
query |
boolean |
Kembalikan 'recognitionModel' atau tidak. Nilai defaultnya adalah false. |
|
start
|
query |
string |
Mencantumkan sumber daya yang lebih besar dari "mulai". Ini berisi tidak lebih dari 64 karakter. Defaultnya kosong. |
|
top
|
query |
integer int32 |
Jumlah item yang akan dicantumkan, berkisar di [1, 1000]. Defaultnya adalah 1000. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
Panggilan yang berhasil mengembalikan array Large Face Lists dan informasinya (largeFaceListId, nama, dan userData). |
|
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 LargeFaceLists
Sample Request
GET {endpoint}/face/v1.1-preview.1/largefacelists?start=my_list_id&top=20&returnRecognitionModel=True
Sample Response
[
{
"name": "your_large_face_list_name",
"userData": "your_user_data",
"recognitionModel": "recognition_01",
"largeFaceListId": "your_large_face_list_id"
}
]
Definisi
Nama | Deskripsi |
---|---|
Face |
Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Face Service, silakan lihat tautan berikut: https://aka.ms/face-error-codes-and-messages. |
Face |
Respons yang berisi detail kesalahan. |
Large |
Daftar wajah besar adalah daftar wajah, hingga 1.000.000 wajah. |
Recognition |
Model pengenalan untuk wajah. |
FaceError
Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Face Service, 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. |
LargeFaceList
Daftar wajah besar adalah daftar wajah, hingga 1.000.000 wajah.
Nama | Jenis | Deskripsi |
---|---|---|
largeFaceListId |
string |
Karakter yang valid adalah huruf dalam huruf kecil atau digit atau '-' atau '_', panjang maksimum adalah 64. |
name |
string |
Nama yang ditentukan pengguna, panjang maksimum adalah 128. |
recognitionModel |
Nama model pengenalan. Model pengenalan digunakan saat fitur wajah diekstraksi dan dikaitkan dengan faceId yang terdeteksi. |
|
userData |
string |
Data opsional yang ditentukan pengguna. 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. |