Reconocimiento de celebridades

En esta página, se describe cómo reconocer a las celebridades en un video con la API de Video Intelligence.

La API de Video Intelligence puede inspeccionar tu contenido de video para detectar rostros humanos que aparecen en el segmento de video o video de entrada. Cuando reconoce un rostro, la API de Video Intelligence puede compararlo con una colección de celebridades recopiladas por Google.

Si se encuentra una coincidencia, la API de Video Intelligence proporciona el ID de máquina (MID) del Gráfico de conocimiento y el nombre de la celebridad y un cuadro de límite que indica dónde aparece el rostro en el video.

Solicita acceso a la función

Esta función se diseñó para que la usen las empresas de medios de comunicación y entretenimiento o socios aprobados que trabajan con contenido multimedia profesional. Para solicitar acceso a la API, envía este formulario con información sobre tu empresa y tu caso práctico.

Reconoce a una celebridad en un video

Los siguientes ejemplos de código demuestran cómo reconocer la cara de una celebridad en un video. La muestra usa el campo opcional outputUri en la solicitud para especificar una ubicación para los resultados de la anotación.

LÍNEA DE REST Y CMD

Envía la solicitud

A continuación, se muestra cómo enviar una solicitud POST al método annotate. En el ejemplo, se usa el token de acceso de una cuenta de servicio que se configuró para el proyecto con el SDK de Cloud. Para obtener instrucciones sobre cómo instalar el SDK de Cloud, configurar un proyecto con una cuenta de servicio y obtener un token de acceso, consulta la guía de inicio rápido de Video Intelligence.

Antes de usar cualquiera de los siguientes datos de solicitud, realiza estos reemplazos:

  • input-uri: Es la ubicación de Cloud Storage del archivo de video que deseas anotar.
  • output-uri: Es la ubicación de Cloud Storage en la que quieres que se guarden los resultados.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "inputUri": "gs://input-uri",
  "outputUri": "gs://output-uri",
  "features": ["CELEBRITY_RECOGNITION"]
}

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:


{
  "name": "projects/project-number/locations/location-id/operations/operation-id"
}

Si la solicitud es exitosa, Video Intelligence muestra el nombre de tu operación.

Obtén los resultados

Para obtener los resultados de tu solicitud, debes enviar una solicitud GET al recurso projects.operations. A continuación, se muestra cómo enviar una solicitud de este tipo.

Antes de usar cualquiera de los siguientes datos de solicitud, realiza estos reemplazos:

  • operation-name: Es el campo name que muestra la llamada a la API de Video Intelligence. Este es un valor en el formato:
    projects/project-number/locations/location-id/operations/operation-id,
    donde:
    • project-number es el número de tu proyecto de Google Cloud.
    • location-id es la región de la nube donde se realizó la anotación (por ejemplo: us-east1, us-west1, europe-west1, asia-east1).
    • operation-id es el ID de la operación de larga duración.

Método HTTP y URL:

GET https://videointelligence.googleapis.com/v1/operation-name

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

El resultado de la anotación del video debería ser similar al siguiente ejemplo.


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

Solicita la exclusión de celebridades

Si eres una celebridad y deseas que no se te incluya en esta función para la API de Cloud Vision o Video Intelligence, envía este formulario.

Denuncia el uso inadecuado

Si sospechas que la función de reconocimiento de celebridades de la API de Video Intelligence se está usando de manera incorrecta, infórmanos mediante este formulario.