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 di video input atau segmen video. Saat mengenali wajah, Video Intelligence API dapat membandingkan wajah dengan koleksi selebritas yang disusun oleh Google.

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

Meminta akses ke fitur

Fitur ini dimaksudkan untuk digunakan oleh media perusahaan hiburan atau partner yang disetujui oleh perusahaan tersebut pada konten media yang diproduksi secara profesional. Untuk meminta akses API, harap kirimkan formulir ini beserta informasi mengenai perusahaan Anda dan kasus penggunaan.

Mengenali selebriti dalam video

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

REST

Kirim 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 hasilnya.
  • 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 dilakukan (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 mirip dengan 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 seorang 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 melalui formulir ini.