Video Intelligence API dapat mengidentifikasi entitas yang ditampilkan dalam rekaman video menggunakan fitur LABEL_DETECTION. Fitur ini mengidentifikasi objek, lokasi, aktivitas, spesies hewan, produk, dan lainnya.
Analisis dapat dibagi menjadi beberapa bagian sebagai berikut:
- Tingkat frame:
Entitas diidentifikasi dan diberi label dalam setiap frame (dengan sampling satu frame per detik). - Tingkat pengambilan gambar:
Pengambilan gambar otomatis terdeteksi dalam setiap segmen (atau video). Entitas kemudian diidentifikasi dan diberi label dalam setiap pengambilan gambar. - Tingkat segmen:
Segmen video yang dipilih pengguna dapat ditentukan untuk analisis dengan menetapkan 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 adalah contoh cara melakukan analisis video untuk label pada file lokal.
Mencari informasi yang lebih mendalam? Lihat tutorial Python mendetail kami.
REST
Mengirim permintaan proses
Berikut ini cara mengirim permintaan POST
ke metode
videos:annotate
. Anda dapat mengonfigurasi
LabelDetectionMode
ke anotasi tingkat pengambilan gambar dan/atau tingkat 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 kunjungi 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 kunjungi Dokumentasi referensi Video Intelligence untuk Ruby.
Menganotasi file di Cloud Storage
Berikut adalah contoh cara melakukan analisis video untuk label pada file yang terletak 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 anotasikan, termasuk nama file. 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:
Mendownload hasil anotasi
Salin anotasi dari sumber ke bucket tujuan: (lihat Menyalin file dan objek)
gcloud storage cp gcs_uri gs://my-bucket
Catatan: Jika uri gcs output disediakan oleh pengguna, anotasi akan disimpan di uri gcs tersebut.
Go
Java
Node.js
Python
Bahasa tambahan
C#: Ikuti Petunjuk penyiapan C# di halaman library klien, lalu kunjungi 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 kunjungi Dokumentasi referensi Video Intelligence untuk Ruby.