Bagikan melalui

Face Recognition Operations - Group

  • Referensi
Service:
Azure AI Services
API Version:
v1.1-preview.1

Bagilah 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.
    • Group API 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 faceId 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 "Deteksi". Maksimum adalah 1000 wajah.

Respons

Nama Jenis Deskripsi
200 OK

GroupingResult

Panggilan yang berhasil mengembalikan satu atau beberapa grup wajah serupa (peringkat menurut ukuran grup) dan messyGroup.
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

Group Face IDs

Sample Request

POST {endpoint}/face/v1.1-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"
  ]
}

Sample Response

Status code:
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, silakan 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, 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.

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.