识别名人

本页面介绍了如何使用 Video Intelligence API 识别视频中的名人。

Video Intelligence API 可以检查您的视频内容,以检测和跟踪输入视频或视频片段中出现的人脸。识别出人脸后,Video Intelligence API 可以将人脸与 Google 整理的名人集合进行比对。

如果找到匹配项,Video Intelligence API 会提供知识图谱机器 ID (MID) 以及名人的姓名并显示人脸在视频中出现的位置的边界框。

请求访问此功能

此功能仅供媒体和娱乐公司或获得批准的合作伙伴用于专业制作的媒体内容。如需申请 API 访问权限,请提交此表单,在其中提供有关您的公司和用例的信息。

识别视频中的名人

以下代码示例演示了如何识别视频中名人的人脸。此示例在请求中使用可选的 outputUri 字段指定注解结果的位置。

REST

发送请求

下面演示了如何向 annotate 方法发送 POST 请求。该示例使用通过 Google Cloud CLI 为项目设置的服务帐号的访问令牌。如需了解有关安装 Google Cloud CLI、使用服务帐号设置项目以及获取访问令牌的说明,请参阅 Video Intelligence 快速入门

在使用任何请求数据之前,请先进行以下替换:

  • INPUT_URI:要添加注释的视频文件的 Cloud Storage 位置。
  • OUTPUT_URI:您希望将结果保存到的 Cloud Storage 位置。
  • PROJECT_NUMBER:您的 Google Cloud 项目的数字标识符

HTTP 方法和网址:

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

请求 JSON 正文:

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

如需发送您的请求,请展开以下选项之一:

您应该收到类似以下内容的 JSON 响应:


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

如果请求成功,Video Intelligence 将返回操作的名称。

获取结果

如需获取请求的结果,您必须向 projects.operations 资源发送 GET 请求。下面演示了如何发送此类请求。

在使用任何请求数据之前,请先进行以下替换:

  • OPERATION_NAME:从 Video Intelligence API 调用返回的 name 字段。值的格式为:
    projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID
    ,其中:
    • PROJECT_NUMBER 是您的 Google Cloud 项目的编号
    • LOCATION_ID 是进行注解的云地区(例如:us-east1us-west1europe-west1asia-east1),
    • OPERATION_ID 是长时间运行的操作的 ID。

HTTP 方法和网址:

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

如需发送您的请求,请展开以下选项之一:

您应该收到类似以下内容的 JSON 响应:

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

为视频添加注释的输出应类似于以下示例。


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

申请退出名人选择

如果您是一位名人,并且不希望被包括在 Cloud Vision 或 Video Intelligence API 的此项功能中,请提交此表单

举报滥用行为

如果您怀疑 Video Intelligence API 名人识别功能被滥用,请通过此表单告知我们。