Face List Operations - Add Face List Face

Tjänst:

Azure AI Services

API-version:

v1.2-preview.1

Lägg till ett ansikte i en angiven ansiktslista, upp till 1 000 ansikten.
För att hantera en bild som innehåller flera ansikten kan indataansikte anges som en bild med en targetFace-rektangel. Det returnerar ett persistedFaceId som representerar det tillagda ansiktet. Ingen avbildning kommer att lagras. Endast de extraherade ansiktsfunktionerna lagras på servern tills "Ta bort ansiktslista" eller "Ta bort ansiktslista" 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 ögonen) 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 bildfilens storlek ä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), kommer stora huvudpositioner eller stora ocklusioner att orsaka fel.
  • Den minsta detekterbara ansiktsstorleken är 36 x 36 bildpunkter i en bild som inte är större än 1920x1080 bildpunkter. Bilder med dimensioner som är högre än 1920 x 1 080 bildpunkter behöver en proportionellt större minsta ansiktsstorlek.
  • Olika "detectionModel"-värden kan anges. Om du vill använda och jämföra olika identifieringsmodeller kan du läsa https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model

POST {endpoint}/face/{apiVersion}/facelists/{faceListId}/persistedfaces

Med valfria parametrar:

POST {endpoint}/face/{apiVersion}/facelists/{faceListId}/persistedfaces?_overload=addFaceListFace&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).
faceListId	path	True	string	Giltigt tecken är bokstav i gemener eller siffror eller "-" eller "_", maximal längd är 64. Reguljärt uttrycksmönster: ^[a-z0-9-_]+$
detectionModel	query		DetectionModel	"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 det målansikte 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 1 000.

Begärandetext

Media Types: "application/octet-stream"

Name	Typ	Description
imageContent	string	Bilden som ska analyseras

Svar

Name	Typ	Description
200 OK	AddFaceResult	Ett lyckat anrop returnerar ett nytt persistedFaceId.
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 FaceList

Exempelbegäran

HTTP

POST {endpoint}/face/v1.2-preview.1/facelists/your_face_list_id/persistedfaces?_overload=addFaceListFace&targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data

"<your-image-bytes-here>"

Exempelsvar

Statuskod:

200

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

Definitioner

Name	Description
AddFaceResult	Svarstext för att lägga till ansikte.
DetectionModel	"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. 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.

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

"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 nästan frontal ansiktsidentifiering. För scenarier med exceptionellt stora vinkeln (huvud-pose) ansikten, ockluderade ansikten eller fel bildorientering, ansikten i sådana fall kanske 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. 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.