Large Person Group Person - Add Face From Url

Hiermit fügen Sie einer Person für die Gesichtsidentifikation oder -verifizierung ein Gesicht in einer umfangreichen Personengruppe hinzu. Um ein Bild mit mehreren Gesichtern zu behandeln, kann das Eingabegesicht als Bild mit einem TargetFace-Rechteck angegeben werden. Es gibt eine persistedFaceId zurück, die das hinzugefügte Gesicht darstellt. Es wird kein Bild gespeichert. Nur das extrahierte Gesichtsfeature wird auf dem Server gespeichert, bis LargePersonGroup PersonFace - Delete, LargePersonGroup Person - Delete oder LargePersonGroup - Delete aufgerufen wird.
Hinweis persistedFaceId unterscheidet sich von faceId, die von Face generiert wird – Erkennen.

  • Höhere Gesichtsbildqualität bedeutet eine bessere Erkennungsgenauigkeit. Bitte berücksichtigen Sie hochwertige Gesichter: Frontal, Klar und Gesichtsgröße beträgt 200x200 Pixel (100 Pixel zwischen Augen) oder größer.
  • Jeder Personeneintrag kann bis zu 248 Gesichter enthalten.
  • JPEG, PNG, GIF (erster Frame) und BMP-Format werden unterstützt. Die zulässige Bilddateigröße beträgt 1 KB bis 6 MB.
  • Das Rechteck "targetFace" sollte ein Gesicht enthalten. Null oder mehrere Gesichter werden als Fehler betrachtet. Wenn das angegebene "targetFace"-Rechteck nicht von Face zurückgegeben wird – Erkennen, gibt es keine Garantie, das Gesicht erfolgreich zu erkennen und hinzuzufügen.
  • Außerhalb der erkennbaren Gesichtsgröße (36x36 - 4096x4096 Pixel), große Kopfpose oder große Okklusionen verursachen Fehler.
  • Das Hinzufügen/Löschen von Gesichtern zu/aus derselben Person wird sequenziell verarbeitet. Das Hinzufügen/Löschen von Gesichtern zu/aus verschiedenen Personen wird parallel verarbeitet.
  • Die minimale erkennbare Gesichtsgröße beträgt 36x36 Pixel in einem Bild, das nicht größer als 1920x1080 Pixel ist. Bilder mit Abmessungen, die größer als 1920x1080 Pixel sind, benötigen eine proportional größere Mindestgröße.
  • Verschiedene "detectionModel"-Werte können bereitgestellt werden. Informationen zum Verwenden und Vergleichen verschiedener Erkennungsmodelle finden Sie unter "Angeben eines Erkennungsmodells".
POST {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces
POST {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}/persons/{personId}/persistedfaces?userData={userData}&targetFace={targetFace}&detectionModel={detectionModel}

URI-Parameter

Name In Required Type Description
Endpoint
path True
  • string

Unterstützte Kognitive Dienste-Endpunkte (Protokoll und Hostname, z. B. : https://westus.api.cognitive.microsoft.com).

largePersonGroupId
path True
  • string

Id, die auf eine bestimmte große Personengruppe verweist.

Regex pattern: ^[a-z0-9-_]+$

personId
path True
  • string
uuid

Id, die auf eine bestimmte Person verweist.

detectionModel
query

Name des Erkennungsmodells. Das Erkennungsmodell wird verwendet, um Gesichter im übermittelten Bild zu erkennen. Ein Erkennungsmodellname kann beim Ausführen von Face - Detect or (Large)FaceList - Add Face oder (Large)PersonGroup - Add Face bereitgestellt werden. Der Standardwert ist "detection_01", falls ein anderes Modell erforderlich ist, geben Sie ihn explizit an.

targetFace
query
  • array

Ein Gesichtsrechteck, um das Zielgesicht anzugeben, das einer Person im Format "targetFace=left,top,width,height" hinzugefügt werden soll. Beispielsweise "targetFace=10,10.100.100.100". Wenn mehr als ein Gesicht im Bild vorhanden ist, muss TargetFace angeben, welches Gesicht hinzugefügt werden soll. Kein TargetFace bedeutet, dass nur ein Gesicht im gesamten Bild erkannt wird.

userData
query
  • string

Benutzerspezifische Daten über das Gesicht für jeden Zweck. Die maximale Länge beträgt 1 KB.

Anforderungsheader

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string

Anforderungstext

Name Required Type Description
url True
  • string

Öffentlich erreichbare URL eines Bilds

Antworten

Name Type Description
200 OK

Ein erfolgreicher Aufruf gibt die neue persistedFaceId zurück.

Other Status Codes

Fehlerantwort.

Sicherheit

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Beispiele

Add Person face example

Sample Request

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


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

Sample Response

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

Definitionen

APIError

Fehlerinformationen, die von der API zurückgegeben werden

DetectionModel

Name des Erkennungsmodells. Das Erkennungsmodell wird verwendet, um Gesichter im übermittelten Bild zu erkennen. Ein Erkennungsmodellname kann beim Ausführen von Face - Detect or (Large)FaceList - Add Face oder (Large)PersonGroup - Add Face bereitgestellt werden. Der Standardwert ist "detection_01", falls ein anderes Modell erforderlich ist, geben Sie ihn explizit an.

Error

Fehlertext.

ImageUrl
PersistedFace

PersonFace-Objekt.

APIError

Fehlerinformationen, die von der API zurückgegeben werden

Name Type Description
error

Fehlertext.

DetectionModel

Name des Erkennungsmodells. Das Erkennungsmodell wird verwendet, um Gesichter im übermittelten Bild zu erkennen. Ein Erkennungsmodellname kann beim Ausführen von Face - Detect or (Large)FaceList - Add Face oder (Large)PersonGroup - Add Face bereitgestellt werden. Der Standardwert ist "detection_01", falls ein anderes Modell erforderlich ist, geben Sie ihn explizit an.

Name Type Description
detection_01
  • string
detection_02
  • string
detection_03
  • string

Error

Fehlertext.

Name Type Description
code
  • string
message
  • string

ImageUrl

Name Type Description
url
  • string

Öffentlich erreichbare URL eines Bilds

PersistedFace

PersonFace-Objekt.

Name Type Description
persistedFaceId
  • string

Die persistedFaceId des Zielgesichts, das beibehalten wird und nicht abläuft. Anders als faceId erstellt von Face - Erkennen und ablaufen zu dem Zeitpunkt ab, der von faceIdTimeToLive nach dem Erkennungsaufruf angegeben wird.

userData
  • string

Vom Benutzer bereitgestellte Daten, die an das Gesicht angefügt sind. Die Größenbeschränkung beträgt 1 KB.