Freigeben über


Face List - Add Face From Stream

Hiermit fügen Sie ein Gesicht einer angegebenen Liste mit Gesichtern hinzu. Bis zu 1.000 Gesichter können hinzugefügt werden.
Um ein Bild zu behandeln, das mehrere Gesichter enthält, kann die Eingabefläche 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 Gesichtserkennungsfeature wird auf dem Server gespeichert, bis FaceList – Face Delete oder FaceList – Delete aufgerufen wird.
Hinweis: persistedFaceId unterscheidet sich von faceId, die von Face – Detect generiert wird.

  • Höhere Gesichtsbildqualität bedeutet eine bessere Erkennungs- und Erkennungsgenauigkeit. Bitte berücksichtigen Sie hochwertige Gesichter: Die Front-, Klar- und Gesichtsgröße beträgt 200 x 200 Pixel (100 Pixel zwischen den Augen) oder größer.
  • JPEG, PNG, GIF (der erste Frame) und BMP-Format werden unterstützt. Die zulässige Bilddateigröße liegt zwischen 1 KB und 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 – Detect zurückgegeben wird, gibt es keine Garantie, dass das Gesicht erfolgreich erkannt und hinzugefügt wird.
  • Aus der erkennbaren Gesichtsgröße (36x36 – 4096 x 4096 Pixel), große Kopfpose oder große Verschlüsse führen zu Fehlern.
  • Das Hinzufügen/Löschen von Gesichtern zu/aus derselben Gesichtsliste wird sequenziell und zu/aus verschiedenen Gesichtslisten parallel verarbeitet.
  • Die minimale erkennbare Gesichtsgröße beträgt 36 x 36 Pixel in einem Bild, das nicht größer als 1920 x 1080 Pixel ist. Bilder mit einer Größe von mehr als 1920 x 1080 Pixel benötigen eine proportional größere Mindestgröße.
  • Es können verschiedene "detectionModel"-Werte angegeben werden. Informationen zum Verwenden und Vergleichen verschiedener Erkennungsmodelle finden Sie unter Angeben eines Erkennungsmodells.
POST {Endpoint}/face/v1.0/facelists/{faceListId}/persistedfaces
POST {Endpoint}/face/v1.0/facelists/{faceListId}/persistedfaces?overload=stream&userData={userData}&targetFace={targetFace}&detectionModel={detectionModel}

URI-Parameter

Name In Erforderlich Typ Beschreibung
Endpoint
path True

string

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

faceListId
path True

string

Id, die auf eine bestimmte Gesichtsliste verweist.

RegEx-Muster: ^[a-z0-9-_]+$

detectionModel
query

DetectionModel

Name des Erkennungsmodells. Das Erkennungsmodell wird verwendet, um Gesichter im übermittelten Bild zu erkennen. Beim Ausführen von Face - Detect or (Large)FaceList – Add Face oder (Large)PersonGroup – Add Face Oder (Large)PersonGroup – Add Face . Der Standardwert ist "detection_01". Wenn ein anderes Modell benötigt wird, geben Sie es bitte explizit an.

targetFace
query

integer[]

Ein Gesichtsrechteck, um das Zielgesicht anzugeben, das einer Person im Format "targetFace=left,top,width,height" hinzugefügt werden soll. Z.B. "targetFace=10,10,100,100". Wenn das Bild mehrere Gesichter enthält, muss targetFace angeben, welches Gesicht hinzugefügt werden soll. Kein targetFace bedeutet, dass nur ein Gesicht im gesamten Bild erkannt wird.

userData
query

string

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

Anforderungsheader

Media Types: "application/octet-stream"

Name Erforderlich Typ Beschreibung
Ocp-Apim-Subscription-Key True

string

Anforderungstext

Media Types: "application/octet-stream"

Name Typ Beschreibung
Image

object

Ein Bildstream.

Antworten

Name Typ Beschreibung
200 OK

PersistedFace

Ein erfolgreicher Aufruf gibt eine neue persistedFaceId zurück.

Other Status Codes

APIError

Fehlerantwort.

Sicherheit

Ocp-Apim-Subscription-Key

Typ: apiKey
In: header

Beispiele

Add face to face list from stream example

Beispielanforderung

POST {Endpoint}/face/v1.0/facelists/sample_face_list/persistedfaces?overload=stream&userData={Customized user data}&targetFace=10,10,100,100&detectionModel=detection_01


"{Image stream in base 64 encoded format}"

Beispiel für eine Antwort

{
  "persistedFaceId": "B8D802CF-DD8F-4E61-B15C-9E6C5844CCBA"
}

Definitionen

Name Beschreibung
APIError

Von der API zurückgegebene Fehlerinformationen

DetectionModel

Name des Erkennungsmodells. Das Erkennungsmodell wird verwendet, um Gesichter im übermittelten Bild zu erkennen. Beim Ausführen von Face - Detect or (Large)FaceList – Add Face oder (Large)PersonGroup – Add Face Oder (Large)PersonGroup – Add Face . Der Standardwert ist "detection_01". Wenn ein anderes Modell benötigt wird, geben Sie es bitte explizit an.

Error

Fehlertext.

PersistedFace

PersonFace-Objekt.

APIError

Von der API zurückgegebene Fehlerinformationen

Name Typ Beschreibung
error

Error

Fehlertext.

DetectionModel

Name des Erkennungsmodells. Das Erkennungsmodell wird verwendet, um Gesichter im übermittelten Bild zu erkennen. Beim Ausführen von Face - Detect or (Large)FaceList – Add Face oder (Large)PersonGroup – Add Face Oder (Large)PersonGroup – Add Face . Der Standardwert ist "detection_01". Wenn ein anderes Modell benötigt wird, geben Sie es bitte explizit an.

Name Typ Beschreibung
detection_01

string

detection_02

string

detection_03

string

Error

Fehlertext.

Name Typ Beschreibung
code

string

message

string

PersistedFace

PersonFace-Objekt.

Name Typ Beschreibung
persistedFaceId

string

Die persistedFaceId der Zielfläche, die beibehalten wird und nicht abläuft. Anders als faceId, die von Face erstellt wurde : Erkennen und läuft in ab, zu dem von faceIdTimeToLive nach dem Erkennungsaufruf angegebenen Zeitpunkt.

userData

string

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