前置條件:建立使用已部署索引的 Batch 影片倉庫。
在控制台搜尋批次影片倉儲資料
控制台
開啟 Vertex AI Vision 資訊主頁的「倉庫」分頁。
找出要搜尋的索引端點,然後按一下「搜尋資產」。
你會看到影片清單 (每部影片對應至一個資產),以及頂端的搜尋列。你可以點選影片來觀看,或開始搜尋影片。
如要開始搜尋,請輸入文字查詢或上傳圖片做為搜尋查詢。搜尋結果頁面右側會顯示影片片段清單,每個影片片段都對應至資產中的連續影片片段。系統會根據輸入查詢的關聯性為短片排序。
您可以使用搜尋結果頁面左側的
Filters
專區,調整搜尋條件。每個篩選條件都包含資料結構定義鍵和要搜尋的註解值。指定篩選條件後,請按一下「搜尋」執行搜尋。
使用指令列搜尋 Batch Video Warehouse 資料
如要搜尋語料庫 (corpus
) 中的影片 (assets
),請在 searchIndexEndpoint
request body 中填入您要搜尋的內容。這類內容有幾種格式:
text_query
或image_query
:要搜尋的查詢。- 選用
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" } ] }