Rilevamento facciale

La funzionalità di riconoscimento facciale dell'API Video Intelligence cerca i volti in un video e restituisce:

  • Il segmento video o i segmenti in cui viene rilevato un volto, in tutti i video della richiesta specificata.

  • (Facoltativo) Riquadri di delimitazione che definiscono l'area del fotogramma video in cui viene rilevato il volto. Per attivare questa funzionalità, imposta il campo includeBoundingBoxes in FaceDetectionConfig su True.

  • Facoltativo: gli attributi rilevati del volto. Per attivare il rilevamento degli attributi, imposta il campo includeAttributes all'interno di FaceDetectionConfig su True. (nota: devi anche impostare includeBoundingBoxes su True). Consulta anche DetectedAttribute.

    Possibili attributi booleani:

Attributo Descrizione
headwear La persona indossa un copricapo, come un cappello, un berretto o un foulard. Non include piccoli oggetti che tengono i capelli (ad es. forcine).
frontal_gaze Se gli occhi della persona guardano direttamente la fotocamera, anziché essere semplicemente entrambi visibili.
eyes_visible La sclera (la parte bianca dell'occhio) è visibile per entrambi gli occhi.
glasses La persona indossa gli occhiali sugli occhi. Gli occhiali possono essere trasparenti o colorati. Nota: se indossati in qualsiasi altro modo (ad es. sulla testa, intorno al collo), gli occhiali vengono ignorati.
mouth_open La persona ha la bocca aperta.
smiling (immagine deprecata) Ritirato: a partire dal 15 ottobre 2026, l'attributo smiling è deprecato e non viene più restituito per i nuovi progetti o per i progetti senza un utilizzo recente del riconoscimento facciale. A partire dal 14 gennaio 2027, questo attributo verrà rimosso definitivamente per tutti i progetti.

Per un esempio, consulta Riconoscimento facciale.

Visualizzatore API Video Intelligence

Dai un'occhiata al visualizzatore dell'API Video Intelligence per vedere questa funzionalità in azione.