Pengenalan selebritis

Halaman ini menjelaskan cara mengenali selebritas dalam gambar menggunakan Vision API.

Vision API memungkinkan Anda untuk mendeteksi wajah dalam gambar. Saat mengenali wajah, Vision API dapat membandingkan wajah dengan galeri terindeks yang menampilkan selebritas yang disusun oleh Google.

Vision API dapat mengenali ribuan selebritas dan dimaksudkan hanya untuk konten media yang difoto secara profesional yang biasanya menampilkan selebritas yang dikenali dalam gambar.

Jika kecocokan ditemukan, Vision API akan memberikan ID Mesin (MID) Pustaka Pengetahuan selebritas, namanya dan kotak pembatas yang menunjukkan tempat wajah tersebut muncul dalam gambar.

Meminta Akses API

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

Meminta Pengenalan Selebriti untuk gambar lokal

Anda dapat menggunakan Vision API untuk melakukan deteksi fitur pada file gambar lokal.

Untuk permintaan REST, kirim konten file gambar sebagai string yang berenkode base64 dalam isi permintaan Anda.

Untuk permintaan gcloud library klien, tentukan jalur ke gambar lokal dalam permintaan Anda.

Untuk mengirim permintaan Pengenalan Selebritas, pertama Anda mendapat akses fitur untuk project Anda dan menggunakan fiturdeteksi wajah yang ada(FACE_DETECTION enum). Hasilnya berisi informasi selebritas jika selebritas terdeteksi.

REST

Sebelum menggunakan salah satu data permintaan, buat penggantian berikut:

  • BASE64_ENCODED_IMAGE: Representasi base64 (string ASCII) dari data gambar biner Anda. String ini akan terlihat seperti string berikut:
    • /9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
    Kunjungi topik enkode base64 untuk informasi selengkapnya.
  • PROJECT_ID: ID project Google Cloud Anda.

Metode HTTP dan URL: 

POST https://vision.googleapis.com/v1p4beta1/images:annotate

Isi JSON permintaan: 

{
  "requests": [
    {
      "image": {
        "content": "BASE64_ENCODED_IMAGE"
      },
      "features": [
        {
          "type": "FACE_DETECTION"
        }
      ],
      "imageContext": {
        "faceRecognitionParams": {
            "celebritySet": ["builtin/default"]
        }
      }
    }
  ]
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://vision.googleapis.com/v1p4beta1/images:annotate"

PowerShell

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://vision.googleapis.com/v1p4beta1/images:annotate" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Permintaan Pengenalan Selebritas untuk gambar jarak jauh

Anda dapat menggunakan Vision API untuk melakukan deteksi fitur pada file gambar jarak jauh yang terletak di Cloud Storage atau di Web. Untuk mengirim permintaan file jarak jauh, tentukan URL Web atau Cloud Storage URI file dalam isi permintaan.

Untuk mengirim permintaan Pengenalan Selebritas, pertama Anda mendapat akses fitur untuk project Anda dan menggunakan fiturdeteksi wajah yang ada(FACE_DETECTION enum). Hasilnya berisi informasi selebritas jika selebritas terdeteksi.

REST

Sebelum menggunakan salah satu data permintaan, buat penggantian berikut:

  • CLOUD_STORAGE_IMAGE_URI: jalur ke file gambar yang valid di bucket Cloud Storage. Anda setidaknya harus memiliki hak istimewa baca ke file tersebut. Contoh: 
    • gs://my-cloud-bucket/img/celebrity_image.jpg
  • PROJECT_ID: ID project Google Cloud Anda.

Metode HTTP dan URL: 

POST https://vision.googleapis.com/v1p4beta1/images:annotate

Isi JSON permintaan: 

{
  "requests": [
    {
      "image": {
        "source": {
          "imageUri": "CLOUD_STORAGE_FILE_URI"
        }
      },
      "features": [
        {
          "type": "FACE_DETECTION"
        }
      ],
      "imageContext": {
        "faceRecognitionParams": {
            "celebritySet": ["builtin/default"]
        }
      }
    }
  ]
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://vision.googleapis.com/v1p4beta1/images:annotate"

PowerShell

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://vision.googleapis.com/v1p4beta1/images:annotate" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

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 mengisi dan mengirim formulir ini.

Laporkan penyalahgunaan

Jika Anda mencurigai fitur Pengenalan Selebritas Vision API disalahgunakan dengan cara apa pun, beritahu kami melalui formulir ini.