Face Recognition Operations - Group

Service:

Azure AI Services

API Version:

v1.1-preview.1

Dela upp kandidatansikten i grupper baserat på ansiktslikhet.

• • Utdata är en eller flera osammanhängande ansiktsgrupper och en rörigGrupp. En ansiktsgrupp innehåller ansikten som har liknande utseende, ofta av samma person. Ansiktsgrupper rangordnas efter gruppstorlek, dvs. antal ansikten. Observera att ansikten som tillhör samma person kan delas upp i flera grupper i resultatet.
  • MessyGroup är en särskild ansiktsgrupp som innehåller ansikten som inte kan hitta något liknande motstycke från ursprungliga ansikten. Den rörigaGroup visas inte i resultatet om alla ansikten hittade sina motsvarigheter.
  • Grupp-API:et behöver minst 2 kandidatytor och högst 1 000. Vi föreslår att du provar "Verifiera ansikte mot ansikte" när du bara har 2 kandidatytor.
  • FaceId:erna för "recognitionModel" som är associerade med frågeytorna bör vara desamma.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
apiVersion	path	True	string	API-version
endpoint	path	True	string uri	Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://{resource-name}.cognitiveservices.azure.com).

Begärandetext

Name	Obligatorisk	Typ	Description
faceIds	True	string[]	Matris med kandidat faceIds som skapats av "Detect". Maximalt är 1 000 ansikten.

Svar

Name	Typ	Description
200 OK	GroupingResult	Ett lyckat anrop returnerar en eller flera grupper med liknande ansikten (rangordna efter gruppstorlek) och en rörigGrupp.
Other Status Codes	FaceErrorResponse	Ett oväntat felsvar. Headers x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

Den hemliga nyckeln för din Azure AI Face-prenumeration.

Type: apiKey
In: header

AADToken

The Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

Name	Description
https://cognitiveservices.azure.com/.default

Exempel

Group Face IDs

Sample Request

HTTP

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"
  ]
}

Definitioner

Name	Description
FaceError	Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns i följande länk: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Ett svar som innehåller felinformation.
GroupingResult	Svarstext för gruppigenkänning.

FaceError

Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns i följande länk: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Description
code	string	En av en serverdefinierad uppsättning felkoder.
message	string	En läsbar återgivning av felet.

FaceErrorResponse

Ett svar som innehåller felinformation.

Name	Typ	Description
error	FaceError	Felobjektet.

GroupingResult

Svarstext för gruppigenkänning.

Name	Typ	Description
groups	string[]	En partition av de ursprungliga ansiktena baserat på ansiktslikhet. Grupper rangordnas efter antal ansikten.
messyGroup	string[]	Ansikts-ID:ets matris med ansikten som inte kan hitta liknande ansikten från ursprungliga ansikten.