Face List Operations - Train Large Face List

Service:

Azure AI Services

API Version:

v1.1-preview.1

Kirim tugas pelatihan Daftar Wajah Besar.

Pelatihan adalah langkah penting yang hanya dapat digunakan oleh "Temukan Serupa Dari Daftar Wajah Besar" yang terlatih.

Tugas pelatihan adalah tugas asinkron. Waktu pelatihan tergantung pada jumlah entri wajah dalam Daftar Wajah Besar. Bisa dalam hitung detik, atau hingga setengah jam untuk 1.000.000 wajah. Untuk memeriksa penyelesaian pelatihan, silakan gunakan "Dapatkan Status Pelatihan Daftar Wajah Besar".

POST {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/train

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-_]+$

Respons

Nama	Jenis	Deskripsi
202 Accepted		Panggilan yang berhasil mengembalikan isi respons kosong. Headers operation-Location: string
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

Train LargeFaceList

Sample Request

HTTP

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

Sample Response

Status code:

202

operation-Location: https://contoso.com/operationstatus

Definisi

Nama	Deskripsi
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.
FaceErrorResponse	Respons yang berisi detail kesalahan.

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