Dela via


Person Group Person - Add Face From Url

Lägg till ett ansikte till en person i en persongrupp för ansiktsidentifiering eller verifiering. Om du vill hantera en bild som innehåller flera ansikten kan indataansiktet anges som en bild med en targetFace-rektangel. Den returnerar ett persistedFaceId som representerar det tillagda ansiktet. Ingen avbildning kommer att lagras. Endast den extraherade ansiktsfunktionen lagras på servern tills PersonGroup PersonFace – Delete, PersonGroup Person – Delete eller PersonGroup – Delete anropas.
Observera att persistedFaceId skiljer sig från faceId som genereras av Face – Detect.

  • Högre bildkvalitet för ansiktsigenkänning 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 Ansiktsigenkänning – Identifiera 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.
  • Tillägg/borttagning av ansikten till/från samma person kommer att bearbetas sekventiellt. Tillägg/borttagning av ansikten till/från olika personer bearbetas parallellt.
  • Den minsta identifierbara ansiktsstorleken är 36 x 36 bildpunkter i en bild som inte är större än 1 920 x 1 080 bildpunkter. Bilder med dimensioner som är högre än 1 920 x 1 080 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 Så här anger du en identifieringsmodell.
POST {Endpoint}/face/v1.0/persongroups/{personGroupId}/persons/{personId}/persistedfaces
POST {Endpoint}/face/v1.0/persongroups/{personGroupId}/persons/{personId}/persistedfaces?userData={userData}&targetFace={targetFace}&detectionModel={detectionModel}

URI-parametrar

Name I Obligatorisk Typ Description
Endpoint
path True

string

Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://westus.api.cognitive.microsoft.com).

personGroupId
path True

string

ID som refererar till en viss persongrupp.

Reguljärt uttrycksmönster: ^[a-z0-9-_]+$

personId
path True

string

uuid

ID som refererar till en viss person.

detectionModel
query

DetectionModel

Namn på identifieringsmodell. Identifieringsmodellen används för att identifiera ansikten i den skickade bilden. Ett namn på identifieringsmodellen kan anges när du utför Ansiktsigenkänning – Identifiera eller (stor)Ansiktslista – Lägg till ansikte eller (stor)PersonGroup – Lägg till ansikte. Standardvärdet är "detection_01", om en annan modell behövs anger du det uttryckligen.

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". Till exempel "targetFace=10,10,100,100". Om det finns fler än ett ansikte i bilden krävs targetFace för att ange vilket ansikte som ska läggas till. Inget targetFace innebär att det bara finns ett ansikte som identifieras i hela bilden.

userData
query

string

Användardefinierade data om ansiktet för valfritt ändamål. Den maximala längden är 1 kB.

Begärandehuvud

Name Obligatorisk Typ Description
Ocp-Apim-Subscription-Key True

string

Begärandetext

Name Obligatorisk Typ Description
url True

string

Offentligt nåbar URL för en bild

Svar

Name Typ Description
200 OK

PersistedFace

Ett lyckat anrop returnerar det nya persistedFaceId.

Other Status Codes

APIError

Felsvar.

Säkerhet

Ocp-Apim-Subscription-Key

Typ: apiKey
I: header

Exempel

Add Person face example

Exempelbegäran

POST {Endpoint}/face/v1.0/persongroups/abc/persons/4caa25ee-3bc6-4e88-adf8-12455ce7aab0/persistedfaces?userData={customized User data}&targetFace=10,10,100,100&detectionModel=detection_01


{
  "url": "{Image Url here}"
}

Exempelsvar

{
  "persistedFaceId": "6e04c175-219e-42a2-9d26-0e7b790e1ef4"
}

Definitioner

Name Description
APIError

Felinformation som returneras av API:et

DetectionModel

Namn på identifieringsmodell. Identifieringsmodellen används för att identifiera ansikten i den skickade bilden. Ett namn på identifieringsmodellen kan anges när du utför Ansiktsigenkänning – Identifiera eller (stor)Ansiktslista – Lägg till ansikte eller (stor)PersonGroup – Lägg till ansikte. Standardvärdet är "detection_01", om en annan modell behövs anger du det uttryckligen.

Error

Feltext.

ImageUrl
PersistedFace

PersonFace-objekt.

APIError

Felinformation som returneras av API:et

Name Typ Description
error

Error

Feltext.

DetectionModel

Namn på identifieringsmodell. Identifieringsmodellen används för att identifiera ansikten i den skickade bilden. Ett namn på identifieringsmodellen kan anges när du utför Ansiktsigenkänning – Identifiera eller (stor)Ansiktslista – Lägg till ansikte eller (stor)PersonGroup – Lägg till ansikte. Standardvärdet är "detection_01", om en annan modell behövs anger du det uttryckligen.

Name Typ Description
detection_01

string

detection_02

string

detection_03

string

Error

Feltext.

Name Typ Description
code

string

message

string

ImageUrl

Name Typ Description
url

string

Offentligt nåbar URL för en bild

PersistedFace

PersonFace-objekt.

Name Typ Description
persistedFaceId

string

PersistedFaceId för målansiktet, som bevaras och inte upphör att gälla. Skiljer sig från faceId som skapats av Ansiktsigenkänning – Identifiera och upphör att gälla vid den tidpunkt som anges av faceIdTimeToLive efter identifieringsanropet.

userData

string

Användardefinierade data som är kopplade till ansiktet. Storleksgränsen är 1 kB.