Video Intelligence API dapat mengidentifikasi entity yang ditampilkan dalam rekaman video menggunakan fitur LABEL_DETECTION. Fitur ini mengidentifikasi objek, lokasi, aktivitas, spesies hewan, produk, dan lainnya.
Analisis ini dapat dikelompokkan sebagai berikut:
- Level frame:
Entitas diidentifikasi dan diberi label dalam setiap frame (dengan pengambilan sampel satu frame per detik). - Level pengambilan gambar:
Pengambilan gambar otomatis terdeteksi dalam setiap segmen (atau video). Entitas kemudian diidentifikasi dan diberi label dalam setiap gambar. - Tingkat segmen:
Segmen video yang dipilih pengguna dapat ditentukan untuk analisis dengan menentukan selisih waktu awal dan akhir untuk tujuan anotasi (lihat VideoSegment). Entitas kemudian diidentifikasi dan diberi label dalam setiap segmen. Jika tidak ada segmen yang ditentukan, seluruh video akan diperlakukan sebagai satu segmen.
Menganotasi file lokal
Berikut contoh menjalankan analisis video untuk label pada file lokal.
Mencari sesuatu yang lebih mendalam? Lihat tutorial Python terperinci kami.
REST
Mengirim permintaan proses
Berikut ini cara mengirim permintaan POST
ke
metode
videos:annotate
. Anda dapat mengonfigurasi
LabelDetectionMode
untuk anotasi level shot dan/atau level frame. Sebaiknya gunakan
SHOT_AND_FRAME_MODE
. 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:
- BASE64_ENCODED_CONTENT: video Anda sebagai data berenkode base64. Lihat petunjuk cara mengonversi data Anda ke base64.
- PROJECT_NUMBER: ID numerik untuk project Google Cloud Anda
Metode HTTP dan URL:
POST https://videointelligence.googleapis.com/v1/videos:annotate
Meminta isi JSON:
{ "inputContent": "BASE64_ENCODED_CONTENT", "features": ["LABEL_DETECTION"], }
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 operasi Anda.
Mendapatkan hasil
Untuk mendapatkan hasil permintaan, Anda harus mengirim permintaan GET
ke
resource
projects.locations.operations
. Berikut ini cara mengirim permintaan tersebut.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- OPERATION_NAME: nama operasi seperti yang ditampilkan oleh Video Intelligence API. Nama operasi memiliki format
projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID
- PROJECT_NUMBER: ID numerik untuk project Google Cloud Anda
Metode HTTP dan URL:
GET https://videointelligence.googleapis.com/v1/OPERATION_NAME
Untuk mengirim permintaan, perluas salah satu opsi berikut:
Anda akan menerima respons JSON yang mirip dengan yang berikut ini:
Go
Java
Node.js
Python
Untuk informasi selengkapnya tentang cara menginstal dan menggunakan Library Klien Video Intelligence API untuk Python, lihat Library Klien Video Intelligence API.Bahasa tambahan
C#: Ikuti Petunjuk penyiapan C# di halaman library klien lalu buka Dokumentasi referensi Video Intelligence untuk .NET.
PHP: Ikuti petunjuk penyiapan PHP di halaman library klien lalu kunjungi Dokumentasi referensi Video Intelligence untuk PHP.
Ruby: Ikuti petunjuk penyiapan Ruby di halaman library klien, lalu buka Dokumentasi referensi Video Intelligence untuk Ruby.
Menganotasi file di Cloud Storage
Berikut contoh menjalankan analisis video untuk label pada file yang berada di Cloud Storage.
REST
Untuk informasi selengkapnya tentang cara menginstal dan menggunakan Library Klien Video Intelligence API untuk Python, lihat Library Klien Video Intelligence API.Mengirim permintaan proses
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: bucket Cloud Storage yang berisi file yang ingin Anda beri anotasi, termasuk nama file-nya. Harus
diawali dengan
gs://
. - PROJECT_NUMBER: ID numerik untuk project Google Cloud Anda
Metode HTTP dan URL:
POST https://videointelligence.googleapis.com/v1/videos:annotate
Meminta isi JSON:
{ "inputUri": "INPUT_URI", "features": ["LABEL_DETECTION"], }
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 operasi Anda.
Mendapatkan hasil
Untuk mendapatkan hasil permintaan, Anda harus mengirim permintaan GET
ke
resource
projects.locations.operations
. Berikut ini cara mengirim permintaan tersebut.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- OPERATION_NAME: nama operasi seperti yang ditampilkan oleh Video Intelligence API. Nama operasi memiliki format
projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID
- PROJECT_NUMBER: ID numerik untuk project Google Cloud Anda
Metode HTTP dan URL:
GET https://videointelligence.googleapis.com/v1/OPERATION_NAME
Untuk mengirim permintaan, perluas salah satu opsi berikut:
Anda akan menerima respons JSON yang mirip dengan yang berikut ini:
Download hasil anotasi
Salin anotasi dari sumber ke bucket tujuan: (lihat Menyalin file dan objek)
gsutil cp gcs_uri gs://my-bucket
Catatan: Jika output gcs uri disediakan oleh pengguna, anotasi akan disimpan dalam uri gcs tersebut.
Go
Java
Node.js
Python
Bahasa tambahan
C#: Ikuti Petunjuk penyiapan C# di halaman library klien lalu buka Dokumentasi referensi Video Intelligence untuk .NET.
PHP: Ikuti petunjuk penyiapan PHP di halaman library klien lalu kunjungi Dokumentasi referensi Video Intelligence untuk PHP.
Ruby: Ikuti petunjuk penyiapan Ruby di halaman library klien, lalu buka Dokumentasi referensi Video Intelligence untuk Ruby.