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 video input atau segmen video. Saat mengenali wajah, Video Intelligence API dapat membandingkan wajah dengan kumpulan 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 perusahaan media & 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 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 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, serta 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 Google Cloud project

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 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 jumlah 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 pemberian anotasi pada 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 fitur pengenalan selebritas Video Intelligence API disalahgunakan dengan cara apa pun, harap beri tahu kami melalui formulir ini.