搜尋批次影片倉儲資料

前置條件：建立使用已部署索引的 Batch 影片倉庫。

在控制台搜尋批次影片倉儲資料

控制台

  1. 開啟 Vertex AI Vision 資訊主頁的「倉庫」分頁。

    前往「倉庫」分頁

  2. 找出要搜尋的索引端點，然後按一下「搜尋資產」。

  3. 你會看到影片清單 (每部影片對應至一個資產)，以及頂端的搜尋列。你可以點選影片來觀看，或開始搜尋影片。

  4. 如要開始搜尋，請輸入文字查詢或上傳圖片做為搜尋查詢。搜尋結果頁面右側會顯示影片片段清單，每個影片片段都對應至資產中的連續影片片段。系統會根據輸入查詢的關聯性為短片排序。

  5. 您可以使用搜尋結果頁面左側的 Filters 專區，調整搜尋條件。每個篩選條件都包含資料結構定義鍵和要搜尋的註解值。指定篩選條件後，請按一下「搜尋」執行搜尋。

使用指令列搜尋 Batch Video Warehouse 資料

如要搜尋語料庫 (corpus) 中的影片 (assets)，請在 searchIndexEndpoint request body 中填入您要搜尋的內容。這類內容有幾種格式：

  1. text_query 或 image_query：要搜尋的查詢。
  2. 選用 criteria：根據使用者提供的註解篩選條件。

在以下範例中，請考慮包含自然風景影片的字元集。如要擷取與「海灘日落」相關且標有註解 "state": "California" 的所有素材資源，請傳送以下要求：

REST 和指令列

使用任何要求資料之前，請先替換以下項目：

  • REGIONALIZED_ENDPOINT：端點可能包含與 LOCATION_ID 相符的前置字串，例如 europe-west4-。進一步瞭解 地區化端點。
  • PROJECT_NUMBER：您的 Google Cloud 專案編號。
  • LOCATION_ID：您使用 Vertex AI Vision 的區域。例如：us-central1、europe-west4。請參閱可用地區。
  • INDEX_ENDPOINT_ID：目標索引端點的 ID。

HTTP 方法和網址：

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

JSON 要求主體：

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

如要傳送要求，請選擇以下其中一個選項：

curl

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

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

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$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

您應該會收到如下的 JSON 回應：

{
  "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"
    }
  ]
}

如果您有海灘日落的圖片，也可以傳送下列要求 (輸入圖片採用 base64 編碼格式)，將其用作搜尋查詢：

REST 和指令列

使用任何要求資料之前，請先替換以下項目：

  • REGIONALIZED_ENDPOINT：端點可能包含與 LOCATION_ID 相符的前置字串，例如 europe-west4-。進一步瞭解 地區化端點。
  • PROJECT_NUMBER：您的 Google Cloud 專案編號。
  • LOCATION_ID：您使用 Vertex AI Vision 的區域。例如：us-central1、europe-west4。請參閱可用地區。
  • INDEX_ENDPOINT_ID：目標索引端點的 ID。

HTTP 方法和網址：

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

JSON 要求主體：

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

如要傳送要求，請選擇以下其中一個選項：

curl

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

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

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$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

您應該會收到如下的 JSON 回應：

{
  "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"
    }
  ]
}