Person Directory Operations - Get Person Face

Tjänst:

Azure AI Services

API-version:

v1.1-preview.1

Hämta ansiktsinformation för person. Den beständiga personens ansikte anges av dess personId. recognitionModel och persistedFaceId.

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

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).
persistedFaceId	path	True	string uuid	Ansikts-ID för ansiktet.
personId	path	True	string uuid	Personens person-ID.
recognitionModel	path	True	RecognitionModel	"recognitionModel" som är associerad med ansikten.

Svar

Name	Typ	Description
200 OK	PersonDirectoryFace	Ett lyckat anrop returnerar målbeständig ansiktsinformation (persistedFaceId och userData).
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 Ansiktsprenumeration på Azure AI.

Typ: apiKey
I: header

AADToken

Azure Active Directory OAuth2-flödet

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 Face from PersonDirectory Person

Exempelbegäran

HTTP

GET {endpoint}/face/v1.1-preview.1/persons/85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5/recognitionModels/recognition_01/persistedfaces/43897a75-8d6f-42cf-885e-74832febb055

Exempelsvar

Statuskod:

200

{
  "persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055",
  "userData": "your_user_data"
}

Definitioner

Name	Description
FaceError	Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns på följande länk: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Ett svar som innehåller felinformation.
PersonDirectoryFace	Ansiktsresurs för personkatalogperson.
RecognitionModel	Igenkänningsmodellen för ansiktet.

FaceError

Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns på 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.

PersonDirectoryFace

Ansiktsresurs för personkatalogperson.

Name	Typ	Description
persistedFaceId	string	Ansikts-ID för ansiktet.
userData	string	Användardefinierade data som är kopplade till ansiktet. Längdgränsen är 1K.

RecognitionModel

Igenkänningsmodellen för ansiktet.

Name	Typ	Description
recognition_01	string	Standardigenkänningsmodellen för "Detect". Alla faceIds som skapades före mars 2019 är kopplade till den här igenkänningsmodellen.
recognition_02	string	Igenkänningsmodellen släpptes i mars 2019.
recognition_03	string	Igenkänningsmodellen släpptes i maj 2020.
recognition_04	string	Igenkänningsmodellen släpptes i februari 2021. Vi rekommenderar att du använder den här igenkänningsmodellen för bättre igenkänningsprecision.