Menelusuri data Batch Video Warehouse

Prasyarat: buat Penyimpanan Video Batch dengan indeks yang di-deploy.

Menelusuri data Batch Video Warehouse di konsol

Konsol

  1. Buka tab Warehouses di dasbor Vertex AI Vision.

    Buka tab Gudang

  2. Temukan endpoint indeks yang ingin Anda telusuri, lalu klik Telusuri Aset.

  3. Anda akan melihat daftar video (masing-masing sesuai dengan aset), serta satu kotak penelusuran di bagian atas. Anda dapat mengklik video untuk melihatnya, atau mulai menelusuri video.

  4. Untuk mulai menelusuri, masukkan kueri teks atau upload gambar sebagai kueri penelusuran. Anda akan melihat daftar klip video di sisi kanan halaman hasil penelusuran, yang masing-masing sesuai dengan klip video berkelanjutan di aset. Klip video diberi peringkat berdasarkan relevansinya dengan kueri input.

  5. Anda dapat menggunakan bagian Filters di sisi kiri halaman hasil penelusuran untuk menyaring penelusuran. Setiap kriteria filter terdiri dari kunci skema data dan nilai anotasi yang ingin Anda telusuri. Setelah menentukan kriteria filter, klik Telusuri untuk menjalankan penelusuran.

Menelusuri data Batch Video Warehouse menggunakan command line

Untuk menelusuri video (assets) dalam korpus (corpus), isi searchIndexEndpoint isi permintaan dengan konten yang ingin Anda temukan. Konten ini tersedia dalam beberapa format:

  1. text_query atau image_query: Kueri yang akan digunakan untuk menelusuri.
  2. Opsional criteria: Memfilter kriteria pada anotasi yang diberikan pengguna.

Dalam contoh berikut, pertimbangkan korpus yang berisi video pemandangan alam. Untuk mengambil semua aset yang relevan dengan "sunset at beach" dan diberi tag dengan anotasi "state": "California", kirim permintaan berikut:

REST & CMD LINE

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
  • PROJECT_NUMBER: Nomor project Google CloudAnda.
  • LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
  • INDEX_ENDPOINT_ID: ID endpoint indeks target Anda.

Metode HTTP dan URL: 

POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint

Isi JSON permintaan: 

{
  "text_query": "sunset at beach",
  "criteria": [
    {
      "field": "state",
      "text_array": {
          "txt_values": [
            "California"
          ]
      }
    }
  ]
}

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 "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint"

PowerShell

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "searchResultItems": [
    {
      "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_1"
    },
    {
      "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_2"
    }
  ]
}

Jika memiliki gambar matahari terbenam di pantai, Anda juga dapat menggunakannya sebagai kueri penelusuran dengan mengirim permintaan berikut (gambar input dalam format encoding base64):

REST & CMD LINE

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
  • PROJECT_NUMBER: Nomor project Google CloudAnda.
  • LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
  • INDEX_ENDPOINT_ID: ID endpoint indeks target Anda.

Metode HTTP dan URL: 

POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint

Isi JSON permintaan: 

{
  "image_query": {
    "input_image": "IMAGE_BYTES"
  },
  "criteria": [
    {
      "field": "state",
      "text_array": {
          "txt_values": [
            "California"
          ]
      }
    }
  ]
}

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 "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint"

PowerShell

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint" | Select-Object -Expand Content

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

{
  "searchResultItems": [
    {
      "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_1"
    },
    {
      "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_2"
    }
  ]
}