Reconhecer celebridades

Esta página descreve como reconhecer celebridades em um vídeo usando a API Video Intelligence.

A API Video Intelligence pode inspecionar o conteúdo de vídeo para detectar e rastrear rostos humanos que aparecem no vídeo de entrada ou no trecho. Quando reconhece um rosto, a API Video Intelligence pode comparar o rosto com uma coleção de celebridades coletadas pelo Google.

Se uma correspondência for encontrada, a API Video Intelligence vai fornecer o ID de máquina do mapa de informações (MID, na sigla em inglês) e o nome da celebridade, além de uma caixa delimitadora que indica onde o rosto aparece no vídeo.

Solicitar acesso ao recurso

Este recurso destina-se ao uso por empresas de mídia e entretenimento ou por parceiros aprovados que envolve conteúdo de mídia produzido profissionalmente. Para solicitar acesso à API, envie este formulário com informações sobre sua empresa e caso de uso.

Reconhecer uma celebridade em um vídeo

Os exemplos de código a seguir demonstram como reconhecer o rosto de uma celebridade em um vídeo. A amostra usa o campo opcional outputUri na solicitação para especificar um local para os resultados da anotação.

REST

Enviar a solicitação

Veja a seguir como enviar uma solicitação POST para o método annotate. O exemplo usa o token de acesso de uma conta de serviço configurada para o projeto com a Google Cloud CLI. Consulte o Guia de início rápido da Video Intelligence para instruções de como instalar a Google Cloud CLI, configurar um projeto com uma conta de serviço e conseguir um token de acesso.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • INPUT_URI: o local do Cloud Storage do arquivo de vídeo que você quer anotar.
  • OUTPUT_URI: o local do Cloud Storage em que você quer salvar os resultados.
  • PROJECT_NUMBER: o identificador numérico do seu projeto do Google Cloud

Método HTTP e URL: 

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

Corpo JSON da solicitação:

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

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:


{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID"
}

Se a solicitação for bem-sucedida, a Video Intelligence retornará o nome da operação.

Ver os resultados

Para receber os resultados da solicitação, envie uma solicitação GET para o recurso projects.operations. Veja a seguir como enviar essa solicitação.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • OPERATION_NAME: o campo name retornado da chamada para a API Video Intelligence. Este é um valor no formato:
    projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID,
    em que:
    • PROJECT_NUMBER é o número do seu projeto Google Cloud ;
    • LOCATION_ID é a região da nuvem em que a anotação ocorreu (por exemplo: us-east1, us-west1, europe-west1, asia-east1);
    • OPERATION_ID é o ID da operação de longa duração.

Método HTTP e URL:

GET https://videointelligence.googleapis.com/v1/OPERATION_NAME

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

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

A saída da anotação do vídeo deve ser semelhante ao exemplo a seguir.


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

Solicitar desativação de celebridade

Se você é uma celebridade e não quer ser incluído neste recurso para o Cloud Vision ou para a API Video Intelligence, envie este formulário.

Denunciar uso indevido

Se você suspeitar que o recurso de reconhecimento de celebridade da API Video Intelligence está sendo usado de maneira inadequada, informe-nos por meio deste formulário (em inglês).