Face Recognition Operations - Group

Tjänst:

Azure AI Services

API-version:

v1.2-preview.1

Dela upp kandidatansikten i grupper baserat på ansiktslikhet.

• • Utdata är en eller flera uppdelade ansiktsgrupper och en stökig grupp. En ansiktsgrupp innehåller ansikten som har liknande utseende, ofta av samma person. Ansiktsgrupper rangordnas efter gruppstorlek, d.v.s. 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. MessyGroup visas inte i resultatet om alla ansikten hittade sina motsvarigheter.
  • Grupp-API:et behöver minst 2 kandidatytor och högst 1 000. Vi rekommenderar 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 ska 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 (rangordning efter gruppstorlek) och en rörigGrupp.
Other Status Codes	FaceErrorResponse	Ett oväntat felsvar. Sidhuvuden x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

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

Typ: apiKey
I: header

AADToken

The Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: accessCode
Auktoriseringswebbadress: https://api.example.com/oauth2/authorize
Token-webbadress: https://api.example.com/oauth2/token

Omfattningar

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

Exempel

Group Face IDs

Exempelbegäran

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

Exempelsvar

Statuskod:

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. Mer 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. Mer 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 mänsklig läsbar representation 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:er matris med ansikten som inte kan hitta liknande ansikten från ursprungliga ansikten.