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 tuoi contenuti video per rilevare e monitorare i volti umani che appaiono nel video o nel segmento video di input. Quando riconosce un volto, l'API Video Intelligence può confrontarlo con una raccolta di celebrità raccolta da Google.

Se viene trovata una corrispondenza, l'API Video Intelligence fornisce il MID (Knowledge Graph Machine ID) e il nome della celebrità, nonché una riquadro di delimitazione che indica dove appare il volto nel video.

Richiedi l'accesso alla funzionalità

Questa funzionalità è pensata per essere utilizzata da società di media e intrattenimento o partner approvati per contenuti multimediali prodotti professionalmente. Per richiedere 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 di una celebrità in un video. Il sample utilizza il campo facoltativo outputUri nella richiesta per specificare una posizione 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 su come installare Google Cloud CLI, configurare un progetto con un account di servizio e ottenere un token di accesso, consulta la guida rapida di Video Intelligence.

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

  • INPUT_URI: la posizione in Cloud Storage del file video da annotare.
  • OUTPUT_URI: la posizione di Cloud Storage in cui vuoi memorizzare i risultati.
  • 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 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 per l'operazione.

Visualizza i risultati

Per ottenere i risultati della richiesta, devi inviare una richiesta GET alla risorsa projects.operations. Di seguito è riportato un esempio di come inviare una richiesta di questo tipo.

Prima di utilizzare i dati della richiesta, apporta 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 è stata eseguita 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 del video dovrebbe essere simile all'esempio riportato di seguito.


{
  "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": {...}
      } ]
    }
    ...
}

Richiedere la disattivazione del riconoscimento delle celebrità

Se sei una celebrità e non vuoi essere incluso in questa funzionalità per l'API Cloud Vision o Video Intelligence, invia questo modulo.

Segnalare un uso improprio

Se sospetti che la funzionalità di riconoscimento delle celebrità dell'API Video Intelligence sia stata usata in modo improprio, comunicacelo utilizzando questo modulo.