辨識名人

本頁說明如何使用 Video Intelligence API 辨識影片中的名人。

Video Intelligence API 可以檢查影片內容，偵測及追蹤輸入影片或影片片段中出現的人臉。Video Intelligence API 辨識臉孔後，可以與 Google 彙整的名人集合進行比較。

如果找到相符項目，Video Intelligence API 會提供知識圖譜機器 ID (MID) 和名人姓名，以及指出臉部出現在影片中位置的周框。

要求存取這項功能

這項功能適用於媒體和娛樂公司，或經核准的合作夥伴，用於專業製作的媒體內容。如要要求 API 存取權，請填寫這份表單，並提供貴公司和用途的相關資訊。

辨識影片中的名人

下列程式碼範例示範如何辨識影片中的名人臉孔。範例會在要求中使用選用的 outputUri 欄位，指定註解結果的位置。

REST

傳送要求

以下說明如何將 POST 要求傳送至 annotate 方法。範例中使用的存取憑證，屬於使用 Google Cloud CLI 建立的專案服務帳戶。如需安裝 Google Cloud CLI、建立具有服務帳戶的專案，以及取得存取憑證的操作說明，請參閱 Video Intelligence 快速入門導覽課程。

使用任何要求資料之前，請先替換以下項目：

  • INPUT_URI：要加上註解的影片檔案的 Cloud Storage 位置。
  • OUTPUT_URI：您要儲存結果的 Cloud Storage 位置。
  • PROJECT_NUMBER：專案的數值 ID 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 會傳回作業名稱。

取得結果

如要取得要求結果，請傳送 GET 要求至 projects.operations 資源。以下說明如何傳送這類要求。

使用任何要求資料之前，請先替換以下項目：

  • OPERATION_NAME：從 Video Intelligence API 呼叫傳回的 name 欄位。這個值的格式為：
    projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID，
    其中：
    • PROJECT_NUMBER 是專案的編號， Google Cloud
    • LOCATION_ID 是註解作業進行的雲端區域 (例如：us-east1、us-west1、europe-west1、asia-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 名人辨識功能，請填寫這份表單告訴我們。