Face List Operations - Add Face List Face

Service:

Azure AI Services

API Version:

v1.1-preview.1

Fügen Sie einer angegebenen Gesichtsliste ein Gesicht mit bis zu 1.000 Gesichtern hinzu.
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 die extrahierten Gesichtserkennungsfeatures werden auf dem Server gespeichert, bis "Gesichtslistengesicht löschen" oder "Gesichtsliste löschen" aufgerufen wird.

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

• • Höhere Gesichtsbildqualität bedeutet eine höhere 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.
  • 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 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 "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.
  • 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 https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model

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

With optional parameters:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
apiVersion	path	True	string	API-Version
endpoint	path	True	string uri	Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. https://{resource-name}.cognitiveservices.azure.com).
faceListId	path	True	string	Gültige Zeichen sind Kleinbuchstaben oder Ziffern oder "-" oder "_", die maximale Länge beträgt 64. Regex pattern: ^[a-z0-9-_]+$
detectionModel	query		DetectionModel	Das "detectionModel", das den erkannten FaceIds zugeordnet ist. Unterstützte "detectionModel"-Werte sind "detection_01", "detection_02" und "detection_03". Der Standardwert ist "detection_01".
targetFace	query		integer[]	Ein Gesichtsrechteck, um das Zielgesicht anzugeben, das einer Person im Format "targetFace=left,top,width,height" hinzugefügt werden soll.
userData	query		string	Vom Benutzer bereitgestellte Daten, die an das Gesicht angefügt sind. Das Größenlimit beträgt 1K.

Anforderungstext

Media Types: "application/octet-stream"

Name	Typ	Beschreibung
imageContent	string	Das zu analysierende Bild

Antworten

Name	Typ	Beschreibung
200 OK	AddFaceResult	Ein erfolgreicher Aufruf gibt eine neue persistedFaceId zurück.
Other Status Codes	FaceErrorResponse	Eine unerwartete Fehlerantwort. Headers x-ms-error-code: string

Sicherheit

Ocp-Apim-Subscription-Key

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

Type: apiKey
In: header

AADToken

Der Azure Active Directory OAuth2-Flow

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

Name	Beschreibung
https://cognitiveservices.azure.com/.default

Beispiele

Add Face to FaceList

Sample Request

HTTP

POST {endpoint}/face/v1.1-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>"

Sample Response

Status code:

200

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

Definitionen

Name	Beschreibung
AddFaceResult	Antworttext zum Hinzufügen von Gesicht.
DetectionModel	Das "detectionModel", das den erkannten FaceIds zugeordnet ist. Unterstützte "detectionModel"-Werte sind "detection_01", "detection_02" und "detection_03". Der Standardwert ist "detection_01".
FaceError	Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Nachrichten, die vom Gesichtserkennungsdienst zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Eine Antwort, die Fehlerdetails enthält.

AddFaceResult

Antworttext zum Hinzufügen von Gesicht.

Name	Typ	Beschreibung
persistedFaceId	string	Beibehaltene Gesichtserkennungs-ID des hinzugefügten Gesichts, die beibehalten wird und nicht abläuft. Anders als faceId, die in "Detect" erstellt wird und in 24 Stunden nach dem Erkennungsaufruf abläuft.

DetectionModel

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

Name	Typ	Beschreibung
detection_01	string	Das Standarderkennungsmodell. Empfohlen für die Naherkennung des Frontalgesichts. Bei Szenarien mit außergewöhnlich großem Winkel (Kopfhaltung), verdeckten Gesichtern oder falscher Bildausrichtung werden die Gesichter in solchen Fällen möglicherweise nicht erkannt.
detection_02	string	Erkennungsmodell veröffentlicht im Mai 2019 mit verbesserter Genauigkeit, insbesondere auf kleinen, seiten- und verschwommenen Gesichtern.
detection_03	string	Erkennungsmodell im Februar 2021 mit verbesserter Genauigkeit, insbesondere bei kleinen Gesichtern.

FaceError

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

Name	Typ	Beschreibung
code	string	Einer der vom Server definierten Fehlercodes.
message	string	Eine für Menschen lesbare Darstellung des Fehlers.

FaceErrorResponse

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	FaceError	Das Fehlerobjekt.