Mengenali selebritas

Halaman ini menjelaskan cara mengenali selebritas dalam video menggunakan Video Intelligence API.

Video Intelligence API dapat memeriksa konten video Anda untuk mendeteksi dan melacak wajah manusia yang muncul dalam segmen video atau video input. Saat mengenali wajah, Video Intelligence API dapat membandingkan wajah dengan kumpulan selebritas yang dibuat oleh Google.

Jika kecocokan ditemukan, Video Intelligence API akan memberikan ID Mesin Pustaka Pengetahuan (MID) dan nama selebritas, serta kotak pembatas yang menunjukkan tempat munculnya wajah dalam video.

Minta akses ke fitur

Fitur ini dimaksudkan untuk digunakan oleh perusahaan media & hiburan atau partner yang disetujui pada konten media yang diproduksi secara profesional. Untuk meminta akses API, kirimkan formulir ini dengan menyertakan informasi tentang perusahaan dan kasus penggunaan Anda.

Mengenali selebritas dalam video

Contoh kode berikut menunjukkan cara mengenali wajah selebritas dalam video. Contoh ini menggunakan kolom outputUri opsional dalam permintaan guna menentukan lokasi untuk hasil anotasi.

REST

Mengirim permintaan

Berikut ini cara mengirim permintaan POST ke metode annotate. Contoh ini menggunakan token akses untuk akun layanan yang disiapkan untuk project menggunakan Google Cloud CLI. Untuk mengetahui petunjuk cara menginstal Google Cloud CLI, menyiapkan project dengan akun layanan, dan mendapatkan token akses, lihat Panduan memulai Video Intelligence.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • INPUT_URI: lokasi Cloud Storage file video yang ingin Anda anotasi.
  • OUTPUT_URI: lokasi Cloud Storage tempat Anda ingin menyimpan hasil.
  • PROJECT_NUMBER: ID numerik untuk project Google Cloud Anda

Metode HTTP dan URL: 

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

Meminta isi JSON: 

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:


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

Jika permintaan berhasil, Video Intelligence akan menampilkan nama untuk operasi Anda.

Mendapatkan hasil

Untuk mendapatkan hasil permintaan, Anda harus mengirim permintaan GET ke resource projects.operations. Berikut ini cara mengirim permintaan tersebut.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • OPERATION_NAME: kolom name yang ditampilkan dari panggilan ke Video Intelligence API. Ini adalah nilai dalam format:
    projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID,
    dengan:
    • PROJECT_NUMBER adalah nomor project Google Cloud Anda,
    • LOCATION_ID adalah region cloud tempat anotasi terjadi (misalnya: us-east1, us-west1, europe-west1, asia-east1),
    • OPERATION_ID adalah ID operasi yang berjalan lama.

Metode HTTP dan URL: 

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

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

Output dari anotasi video akan terlihat seperti contoh berikut.


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

Meminta pilihan untuk tidak menanggapi selebritas

Jika Anda adalah selebritas dan tidak ingin disertakan dalam fitur ini untuk Cloud Vision atau Video Intelligence API, harap kirimkan formulir ini.

Melaporkan penyalahgunaan

Jika Anda mencurigai bahwa fitur pengenalan selebritas Video Intelligence API disalahgunakan dengan cara apa pun, beri tahu kami menggunakan formulir ini.