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). |
person
|
path | True |
string |
ID som refererar till en viss persongrupp. Reguljärt uttrycksmönster: |
person
|
path | True |
string uuid |
ID som refererar till en viss person. |
detection
|
query |
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. |
||
target
|
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. |
|
user
|
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 |
Ett lyckat anrop returnerar det nya persistedFaceId. |
|
Other Status Codes |
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 |
Detection |
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. |
Image |
|
Persisted |
PersonFace-objekt. |
APIError
Felinformation som returneras av API:et
Name | Typ | Description |
---|---|---|
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. |