Dela via

Person Directory Operations - Get Person Faces

  • Referens
Tjänst:
Azure AI Services
API-version:
v1.2-preview.1

Hämta en persons persistedFaceIds som representerar den registrerade personens ansiktsfunktioner.

GET {endpoint}/face/{apiVersion}/persons/{personId}/recognitionModels/{recognitionModel}/persistedfaces

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).
personId
 path True

string (uuid)

Person-ID för personen.
recognitionModel
 path True

RecognitionModel

Den "recognitionModel" som är associerad med ansikten.

Svar

Name Typ Description
200 OK

ListFaceResult

Ett lyckat anrop returnerar en matris med persistedFaceIds och ett person-ID.
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

Get Faces from PersonDirectory Person

Exempelbegäran

GET {endpoint}/face/v1.2-preview.1/persons/85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5/recognitionModels/recognition_01/persistedfaces

Exempelsvar

Statuskod:
200 
{
  "personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
  "persistedFaceIds": [
    "43897a75-8d6f-42cf-885e-74832febb055"
  ]
}

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

Svar på en persons listansikte.
RecognitionModel

Igenkänningsmodellen för ansiktet.

FaceError

Objekt

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

Objekt

Ett svar som innehåller felinformation.

Name Typ Description
error

FaceError

Felobjektet.

ListFaceResult

Objekt

Svar på en persons listansikte.

Name Typ Description
persistedFaceIds

string[] (uuid)

Matris med bevarade ansikts-ID:t.
personId

string (uuid)

Person-ID.

RecognitionModel

Uppräkning

Igenkänningsmodellen för ansiktet.

Värde Description
recognition_01

Standardigenkänningsmodellen för "Detect". Alla faceIds som skapades före mars 2019 är kopplade till den här igenkänningsmodellen.
recognition_02

Igenkänningsmodellen släpptes 2019 mars.
recognition_03

Igenkänningsmodell som släpptes 2020 maj.
recognition_04

Igenkänningsmodellen släpptes 2021 februari. Vi rekommenderar att du använder den här igenkänningsmodellen för bättre igenkänningsnoggrannhet.