Face List Operations - Add Face List Face

Fügen Sie einer angegebenen Gesichtsliste bis zu 1.000 Gesichter ein Gesicht hinzu.
Um mit einem Bild zu umgehen, das mehrere Gesichter enthält, kann die Eingabeoberflä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 die extrahierten Gesichtsfeatures werden auf dem Server gespeichert, bis "Face List Delete" oder "Delete Face List" aufgerufen wird.

Beachten Sie, dass persistedFaceId sich von "faceId" unterscheidet, die von "Detect" generiert wird.

• • Höhere Gesichtsbildqualität bedeutet eine bessere Erkennungsgenauigkeit. Berücksichtigen Sie qualitativ hochwertige Gesichter: Frontal-, Klar- und Gesichtsgröße beträgt 200 x 200 Pixel (100 Pixel zwischen Augen) oder größer.
  • Jeder Personeneintrag kann bis zu 248 Gesichter enthalten.
  • JPEG, PNG, GIF (der erste 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 bereitgestellte Rechteck "targetFace" nicht von "Erkennen" zurückgegeben wird, gibt es keine Garantie, das Gesicht erfolgreich zu erkennen und hinzuzufügen.
  • Außerhalb der erkennbaren Gesichtsgröße (36 x 36 - 4096x4096 Pixel), große Kopfvorstellung oder große Okklusionen verursachen Fehler.
  • 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 Abmessungen, die größer als 1920 x 1080 Pixel sind, benötigen eine proportional größere Mindestgröße.
  • Es können verschiedene "detectionModel"-Werte bereitgestellt werden. Informationen zum Verwenden und Vergleichen verschiedener Erkennungsmodelle finden Sie unter https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model

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

POST {endpoint}/face/{apiVersion}/facelists/{faceListId}/persistedfaces?_overload=addFaceListFace&targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}

URI-Parameter

Anforderungstext

Media Types: "application/octet-stream"

Antworten

Sicherheit

Ocp-Apim-Subscription-Key

Der geheime Schlüssel für Ihr Azure AI Face-Abonnement.

Typ: apiKey
In: header

AADToken

Der Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiche

Beispiele

Add Face to FaceList

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>"

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

Definitionen

AddFaceResult

Antworttext zum Hinzufügen von Gesicht.

DetectionModel

Das "detectionModel", das den erkannten FaceIds zugeordnet ist. Unterstützte 'detectionModel'-Werte umfassen "detection_01", "detection_02" und "detection_03". Der Standardwert ist "detection_01".

FaceError

Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Nachrichten, die vom Face Service zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.

FaceErrorResponse

Eine Antwort, die Fehlerdetails enthält.