Riconoscimento delle celebrità

Questa pagina descrive come riconoscere le celebrità in un video utilizzando l'API Video Intelligence.

L'API Video Intelligence può ispezionare i contenuti video per rilevare e tenere traccia dei volti umani visualizzati nel segmento video o video di input. Quando riconosce un volto, l'API Video Intelligence può confrontarlo con quello di una raccolta di celebrità selezionate da Google.

Se viene trovata una corrispondenza, l'API Video Intelligence fornisce il ID macchina del Knowledge Graph (MID), il nome della celebrità e un riquadro di delimitazione che indica il punto in cui il volto compare nel video.

Richiedi l'accesso alla funzionalità

Questa funzionalità è destinata alle società di media e intrattenimento o a partner approvati su contenuti multimediali di produzione professionale. Per richiedere l'accesso all'API, invia questo modulo con informazioni sulla tua azienda e sul caso d'uso.

Riconoscere una celebrità in un video

I seguenti esempi di codice mostrano come riconoscere il volto di una celebrità in un video. Nell'esempio viene utilizzato il campo facoltativo outputUri nella richiesta per specificare una località per i risultati dell'annotazione.

REST

Invia la richiesta

Di seguito viene mostrato come inviare una richiesta POST al metodo annotate. L'esempio utilizza il token di accesso per 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 account di servizio e su come ottenere un token di accesso, consulta la guida rapida di Video Intelligence.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • INPUT_URI: la posizione di Cloud Storage del file video su cui vuoi aggiungere annotazioni.
  • OUTPUT_URI: la località di Cloud Storage in cui vuoi salvare i risultati.
  • PROJECT_NUMBER: l'identificatore numerico per il tuo progetto Google Cloud

Metodo HTTP e URL: 

POST https://videointelligence.googleapis.com/v1p3beta1/videos:annotate

Corpo JSON richiesta: 

{
  "inputUri": "gs://INPUT_URI",
  "outputUri": "gs://OUTPUT_URI",
  "features": ["CELEBRITY_RECOGNITION"]
}

Per inviare la richiesta, espandi una di queste 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 dell'operazione.

Visualizza i risultati

Per ottenere i risultati della richiesta, devi inviare una richiesta GET alla risorsa projects.operations. Di seguito viene mostrato come inviare una richiesta di questo tipo.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • OPERATION_NAME: il campo name 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 si è verificata 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 di queste 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 sul video dovrebbe essere simile all'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 disattivazione delle celebrità

Se sei un personaggio famoso e non vuoi che il tuo canale venga incluso in questa funzionalità 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 venga usata in modo improprio, comunicacelo tramite questo modulo.