Die Gesichtserkennungsfunktion der Video Intelligence API sucht nach Gesichtern in einem Video und gibt Folgendes zurück:
Das Videosegment oder die Segmente, in denen ein Gesicht erkannt wurde, in allen Videos im jeweiligen Antrag.
Optional: Begrenzungsrahmen, die den Bereich des Videoframes definieren, in dem das Gesicht erkannt wird. Wenn Sie diese Funktion aktivieren möchten, legen Sie das Feld
includeBoundingBoxesinFaceDetectionConfigaufTruefest.Optional: die erkannten Attribute des Gesichts. Um die Attributerkennung zu aktivieren, setzen Sie das Feld
includeAttributesinFaceDetectionConfigaufTrue. Hinweis: Sie müssen auchincludeBoundingBoxesaufTruefestlegen. Weitere Informationen finden Sie unterDetectedAttribute.Mögliche boolesche Attribute:
| Attribut | Beschreibung |
|---|---|
headwear |
Die Person trägt eine Kopfbedeckung, z. B. einen Hut, eine Mütze oder ein Kopftuch. Kleine Gegenstände, die das Haar halten (z.B. Haarnadeln), sind nicht enthalten. |
frontal_gaze |
Gibt an, ob die Augen der Person direkt in die Kamera schauen und nicht nur beide Augen sichtbar sind. |
eyes_visible |
Der Sclera (das Weiße im Auge) ist in beiden Augen sichtbar. |
glasses |
Die Person trägt eine Brille auf ihrem Gesicht und über ihre Augen. Die Brille kann klar oder farbig sein. Hinweis: Auf andere Weise getragen (z.B. oben am Kopf oder um den Hals) wird die Brille nicht beachtet. |
mouth_open |
Der Mund der Person ist geöffnet. |
smiling (verworfen) |
Eingestellt: Ab dem 15. Oktober 2026 wird das Attribut smiling eingestellt und nicht mehr für neue Projekte oder Projekte ohne aktuelle Nutzung der Gesichtserkennung zurückgegeben.
Ab dem 14. Januar 2027 wird dieses Attribut für alle Projekte endgültig entfernt. |
Ein Beispiel finden Sie unter Gesichtserkennung.
Video Intelligence API-Visualisierer
Sehen Sie sich den Video Intelligence API-Visualisierer an, um diese Funktion in Aktion zu sehen.