Person Directory Operations - Add Person Face From Url

Tjänst:

Azure AI Services

API-version:

v1.1-preview.1

Lägg till ett ansikte till en person (se Person Directory "Skapa Person") för ansiktsidentifiering eller verifiering.
Om du vill hantera en bild som innehåller flera ansikten kan indataansikte anges som en bild med en targetFace-rektangel. Den returnerar ett persistedFaceId som representerar det tillagda ansiktet. Ingen avbildning kommer att lagras. Endast de extraherade ansiktsfunktionerna lagras på servern tills Person Directory "Delete Person Face" eller "Delete Person" anropas.

Observera att persistedFaceId skiljer sig från faceId som genereras av "Detect".

• • Högre ansiktsbildkvalitet innebär bättre igenkänningsprecision. Överväg högkvalitativa ansikten: frontal, klar och ansiktsstorlek är 200 x 200 bildpunkter (100 bildpunkter mellan ögon) eller större.
  • Varje personpost kan innehålla upp till 248 ansikten.
  • JPEG, PNG, GIF (den första ramen) och BMP-format stöds. Den tillåtna bildfilstorleken är från 1 KB till 6 MB.
  • Rektangeln "targetFace" ska innehålla ett ansikte. Noll eller flera ansikten betraktas som ett fel. Om den angivna rektangeln "targetFace" inte returneras från "Detect" finns det ingen garanti för att identifiera och lägga till ansiktet.
  • Av den identifierbara ansiktsstorleken (36 x 36 – 4 096 x 4 096 bildpunkter), orsakar stora huvudpositioner eller stora ocklusioner fel.
  • Den minsta identifierbara ansiktsstorleken är 36 x 36 bildpunkter i en bild som inte är större än 1920 x 1 080 bildpunkter. Bilder med dimensioner som är högre än 1920 x 1080 bildpunkter behöver en proportionellt större minsta ansiktsstorlek.
  • Olika "detectionModel"-värden kan anges. Information om hur du använder och jämför olika identifieringsmodeller finns i https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
• • Att lägga till/ta bort ansikten till/från en samma person bearbetas sekventiellt. Att lägga till/ta bort ansikten till/från olika personer bearbetas parallellt.
  • Det här är en tidskrävande åtgärd. Använd svarshuvudet "Operation-Location" för att avgöra när AddFace-åtgärden har spridits för framtida begäranden till "Identifiera". Mer information om Operation-Locations finns i "Get Face Operation Status".

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

Med valfria parametrar:

POST {endpoint}/face/{apiVersion}/persons/{personId}/recognitionModels/{recognitionModel}/persistedfaces?_overload=addPersonFaceFromUrl&targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}

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.
detectionModel	query		DetectionModel	Den "detectionModel" som är associerad med identifierade faceIds. Värden för "detectionModel" som stöds är "detection_01", "detection_02" och "detection_03". Standardvärdet är "detection_01".
targetFace	query		integer[]	En ansiktsrektangel för att ange målansiktet som ska läggas till i en person, i formatet "targetFace=left,top,width,height".
userData	query		string	Användarangivna data som är kopplade till ansiktet. Storleksgränsen är 1K.

Begärandetext

Name	Obligatorisk	Typ	Description
url	True	string	URL för indatabild.

Svar

Name	Typ	Description
202 Accepted	AddFaceResult	Ett lyckat anrop returnerar en tom svarstext. Tjänsten har accepterat begäran och kommer snart att börja bearbetas. Klienten kan köra frågor mot åtgärdsstatusen och resultatet med hjälp av url:en som anges i svarshuvudet "Åtgärdsplats". URL:en upphör att gälla om 48 timmar. Sidhuvuden Location: string operation-Location: string
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

Add Face to PersonDirectory Person from Url

Exempelbegäran

HTTP

POST {endpoint}/face/v1.1-preview.1/persons/85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5/recognitionModels/recognition_01/persistedfaces?_overload=addPersonFaceFromUrl&targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data

{
  "url": "https://microsoft.com/example.jpg"
}

Exempelsvar

Statuskod:

202

location: https://contoso.com/operationstatus
operation-Location: https://contoso.com/operationstatus

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

Definitioner

Name	Description
AddFaceResult	Svarstext för att lägga till ansikte.
DetectionModel	Den "detectionModel" som är associerad med identifierade faceIds. Värden för "detectionModel" som stöds är "detection_01", "detection_02" och "detection_03". Standardvärdet är "detection_01".
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.
RecognitionModel	Igenkänningsmodellen för ansiktet.

AddFaceResult

Svarstext för att lägga till ansikte.

Name	Typ	Description
persistedFaceId	string	Beständiga ansikts-ID för det tillagda ansiktet, som sparas och inte upphör att gälla. Skiljer sig från faceId som skapas i "Detect" och upphör att gälla om 24 timmar efter identifieringsanropet.

DetectionModel

Den "detectionModel" som är associerad med identifierade faceIds. Värden för "detectionModel" som stöds är "detection_01", "detection_02" och "detection_03". Standardvärdet är "detection_01".

Name	Typ	Description
detection_01	string	Standardidentifieringsmodellen. Rekommendera för ansiktsidentifiering nära fronten. För scenarier med exceptionellt stor vinkel (huvudposition) ansikten, occluded ansikten eller fel bildorientering, kan ansikten i sådana fall inte identifieras.
detection_02	string	Identifieringsmodell som släpptes 2019 maj med förbättrad noggrannhet, särskilt på små, sido- och suddiga ansikten.
detection_03	string	Identifieringsmodell som släpptes 2021 februari med förbättrad noggrannhet, särskilt på små ansikten.

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.

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 2019 mars.
recognition_03	string	Igenkänningsmodellen släpptes 2020 maj.
recognition_04	string	Igenkänningsmodellen släpptes 2021 februari. Vi rekommenderar att du använder den här igenkänningsmodellen för bättre igenkänningsprecision.