Face List Operations - Create Large Face List

Service:

Azure AI Services

API Version:

v1.1-preview.1

Create Daftar Wajah Besar kosong dengan largeFaceListId, nama, userData opsional, dan recognitionModel yang ditentukan pengguna.
Daftar Wajah Besar adalah daftar wajah, hingga 1.000.000 wajah, dan digunakan oleh "Temukan Serupa Dari Daftar Wajah Besar".

Setelah pembuatan, pengguna harus menggunakan Tambahkan Wajah Daftar Wajah Besar untuk mengimpor wajah dan Melatih Daftar Wajah Besar untuk membuatnya siap untuk "Temukan Serupa". Tidak ada gambar yang akan disimpan. Hanya fitur wajah yang diekstrak yang akan disimpan di server hingga Hapus Daftar Wajah Besar dipanggil.

"Temukan Serupa" digunakan untuk skenario seperti menemukan wajah seperti selebriti, pemfilteran wajah serupa, atau sebagai identifikasi wajah dengan cara yang ringan. Tetapi jika penggunaan aktual adalah untuk mengidentifikasi orang, silakan gunakan Grup Orang / Grup Orang Besar dan "Identifikasi".

Catatan

• • Kuota langganan tingkat gratis: 64 Large Face Lists.
  • Kuota langganan tingkat S0: 1.000.000 Lists Wajah Besar.

PUT {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}

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).
largeFaceListId	path	True	string	Karakter yang valid adalah huruf dalam huruf kecil atau digit atau '-' atau '_', panjang maksimum adalah 64. Regex pattern: ^[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 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 LargeFaceList

Sample Request

HTTP

PUT {endpoint}/face/v1.1-preview.1/largefacelists/your_large_face_list_id

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

Sample Response

Status code:

200

Definisi

Nama	Deskripsi
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.
FaceErrorResponse	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	FaceError	Objek kesalahan.