In questa pagina viene descritto come riconoscere le celebrità in un video utilizzando API Video Intelligence.
L'API Video Intelligence può analizzare i contenuti video per rilevare e monitorare volti umani che compaiono nel segmento video o video di input. Quando riconosce un volto, l'API Video Intelligence può confrontarlo con una raccolta di celebrità organizzata da Google.
Se viene trovata una corrispondenza, l'API Video Intelligence fornisce ID macchina Knowledge Graph (MID) il nome della celebrità e un riquadro di delimitazione che indica dove in cui appare un volto nel video.
Richiedi l'accesso alla funzionalità
Questa funzionalità è destinata all'uso da parte di contenuti multimediali e società di intrattenimento o da partner approvati su contenuti multimediali prodotti da professionisti. A richiedi l'accesso all'API, invia questo modulo con informazioni sulla tua azienda e sul tuo caso d'uso.
Riconoscere una celebrità in un video
I seguenti esempi di codice mostrano come riconoscere il
volto in un video. L'esempio utilizza il campo facoltativo outputUri
nella richiesta di specificare una posizione per i risultati dell'annotazione.
REST
Invia la richiesta
Di seguito viene illustrato come inviare una richiesta POST
all'indirizzo
annotate
. L'esempio utilizza il token di accesso per
con un account di servizio configurato per il progetto utilizzando Google Cloud CLI. Per
Istruzioni sull'installazione di Google Cloud CLI, sulla configurazione di un progetto con un servizio
di accesso all'account e ottenere un token di accesso, consulta
Guida rapida di Video Intelligence.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- INPUT_URI: la località di Cloud Storage del al file video a cui vuoi aggiungere un'annotazione.
- OUTPUT_URI: la località di Cloud Storage in cui vuoi che i risultati vengano salvati.
- PROJECT_NUMBER: l'identificatore numerico del tuo progetto Google Cloud
Metodo HTTP e URL:
POST https://videointelligence.googleapis.com/v1p3beta1/videos:annotate
Corpo JSON della richiesta:
{ "inputUri": "gs://INPUT_URI", "outputUri": "gs://OUTPUT_URI", "features": ["CELEBRITY_RECOGNITION"] }
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID" }
Se la richiesta ha esito positivo, Video Intelligence restituisce il nome per la tua operazione.
Ottieni i risultati
Per ottenere i risultati della tua richiesta, devi inviare una richiesta GET
a
projects.operations
risorsa. Di seguito viene illustrato come inviare questa richiesta.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- OPERATION_NAME: il campo
name
è stato restituito dalla chiamata all'API Video Intelligence. Si tratta di un valore nel formato:
projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID
,
dove:- .
- PROJECT_NUMBER è il numero del tuo progetto Google Cloud,
- LOCATION_ID è la regione cloud in cui è avvenuta l'annotazione (ad
esempio:
us-east1
,us-west1
,europe-west1
,asia-east1
), - OPERATION_ID è l'ID dell'operazione a lunga esecuzione.
Metodo HTTP e URL:
GET https://videointelligence.googleapis.com/v1/OPERATION_NAME
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1p3beta1.AnnotateVideoProgress", "annotationProgress": [ { "inputUri": "INPUT_URI", "progressPercent": 100, "startTime": "2020-05-12T19:36:09.110351Z", "updateTime": "2020-05-12T19:36:17.519069Z" } ] }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1p3beta1.AnnotateVideoResponse", "annotationResults": [ { ... } ] } }
L'output dell'annotazione del video dovrebbe essere simile all'output dall'esempio seguente.
{ "annotationResults": [ { "inputUri": "INPUT_URI, "segment": { "startTimeOffset": { }, "endTimeOffset": { "seconds": 19, "nanos": 519500000 } }, "celebrityRecognitionAnnotations": { "celebrityTracks": [ { "celebrities": [...], "faceTrack": {...} }, { "celebrities": [ { "celebrity": { "name": "video-intelligence/CELEBRITY_MID", "displayName": "CELEBRITY_NAME/var>" }, "confidence": 0.81873637 } ], "faceTrack": { "segment": { "startTimeOffset": { "seconds": 1, "nanos": 459791000 }, "endTimeOffset": { "seconds": 3, "nanos": 712041000 } }, "timestampedObjects": [ { "normalizedBoundingBox": {...}, "timeOffset": {...} }, { "normalizedBoundingBox": { "left": 0.38046876, "top": 0.26249999, "right": 0.60312498, "bottom": 0.72361112 }, "timeOffset": { "seconds": 1, "nanos": 459791000 } }, { "normalizedBoundingBox": {...}, "timeOffset": {...} }] } }, { "celebrities": [...], "faceTrack": {...} } ] } ... }
Richiedi la disattivazione della celebrità
Se sei una celebrità e non desideri essere incluso in per l'API Cloud Vision o Video Intelligence invia questo modulo.
Segnala uso improprio
Se sospetti che la funzionalità di riconoscimento delle celebrità dell'API Video Intelligence viene utilizzato in modo improprio, faccelo sapere utilizzando questo modulo.