Face Recognition Operations - Group

Layanan:

Azure AI Services

Versi API:

v1.2-preview.1

Membagi wajah kandidat menjadi beberapa kelompok berdasarkan kesamaan wajah.

• • Outputnya adalah satu atau beberapa grup wajah yang terputus-putus dan messyGroup. Grup wajah berisi wajah yang memiliki tampilan serupa, sering kali dari orang yang sama. Grup wajah diberi peringkat berdasarkan ukuran grup, yaitu jumlah wajah. Perhatikan bahwa wajah milik orang yang sama mungkin dibagi menjadi beberapa kelompok dalam hasilnya.
  • MessyGroup adalah kelompok wajah khusus yang berisi wajah yang tidak dapat menemukan wajah rekan serupa dari wajah asli. MessyGroup tidak akan muncul dalam hasil jika semua wajah menemukan rekan-rekan mereka.
  • API Grup membutuhkan setidaknya 2 wajah kandidat dan paling banyak 1000. Kami menyarankan untuk mencoba "Verifikasi Wajah Ke Wajah" ketika Anda hanya memiliki 2 wajah kandidat.
  • 'recognitionModel' yang terkait dengan faceIds kueri harus sama.

POST {endpoint}/face/{apiVersion}/group

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).

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
faceIds	True	string[]	Array faceId kandidat yang dibuat oleh "Detect". Maksimumnya adalah 1000 wajah.

Respons

Nama	Jenis	Deskripsi
200 OK	GroupingResult	Panggilan yang berhasil mengembalikan satu atau beberapa grup wajah serupa (peringkat berdasarkan ukuran grup) dan messyGroup.
Other Status Codes	FaceErrorResponse	Respons kesalahan tak terduga. Header x-ms-error-code: string

Keamanan

Ocp-Apim-Subscription-Key

Kunci rahasia untuk langganan Azure AI Face Anda.

Jenis: apiKey
Dalam: header

AADToken

Alur OAuth2 Azure Active Directory

Jenis: oauth2
Alur: accessCode
URL Otorisasi: https://api.example.com/oauth2/authorize
URL token: https://api.example.com/oauth2/token

Cakupan

Nama	Deskripsi
https://cognitiveservices.azure.com/.default

Contoh

Group Face IDs

Permintaan sampel

HTTP

POST {endpoint}/face/v1.2-preview.1/group

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426",
    "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
    "65d083d4-9447-47d1-af30-b626144bf0fb",
    "fce92aed-d578-4d2e-8114-068f8af4492e",
    "30ea1073-cc9e-4652-b1e3-d08fb7b95315",
    "be386ab3-af91-4104-9e6d-4dae4c9fddb7",
    "fbd2a038-dbff-452c-8e79-2ee81b1aa84e",
    "b64d5e15-8257-4af2-b20a-5a750f8940e7"
  ]
}

Respon sampel

Kode status:

200

{
  "groups": [
    [
      "c5c24a82-6845-4031-9d5d-978df9175426",
      "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
      "fce92aed-d578-4d2e-8114-068f8af4492e",
      "b64d5e15-8257-4af2-b20a-5a750f8940e7"
    ],
    [
      "65d083d4-9447-47d1-af30-b626144bf0fb",
      "30ea1073-cc9e-4652-b1e3-d08fb7b95315"
    ]
  ],
  "messyGroup": [
    "be386ab3-af91-4104-9e6d-4dae4c9fddb7",
    "fbd2a038-dbff-452c-8e79-2ee81b1aa84e"
  ]
}

Definisi

Nama	Deskripsi
FaceError	Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Layanan Wajah, lihat tautan berikut: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Respons yang berisi detail kesalahan.
GroupingResult	Isi respons untuk operasi wajah grup.

FaceError

Objek kesalahan. Untuk detail komprehensif tentang kode kesalahan dan pesan yang dikembalikan oleh Layanan Wajah, lihat tautan berikut: https://aka.ms/face-error-codes-and-messages.

Nama	Jenis	Deskripsi
code	string	Salah satu sekumpulan 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.

GroupingResult

Isi respons untuk operasi wajah grup.

Nama	Jenis	Deskripsi
groups	string[]	Partisi wajah asli berdasarkan kesamaan wajah. Grup diberi peringkat berdasarkan jumlah wajah.
messyGroup	string[]	Array wajah id wajah yang tidak dapat menemukan wajah serupa dari wajah asli.