在網站上搜尋圖片

透過 Vertex AI Search，您可以使用含有網站資料的應用程式搜尋圖片。您以文字字串或圖片的形式提供查詢，而 default_config.search 方法會傳回該查詢的圖片。

事前準備

請確認您符合下列必要條件。需求條件因搜尋方式而異， 請參閱下文瞭解詳情。

如要使用指令列預覽網站的圖片搜尋結果，請使用 engines.servingConfigs.search 方法：

  1. 找出應用程式 ID。如果已有應用程式 ID，請跳到下一個步驟。

    1. 前往 Google Cloud 控制台的「AI Applications」頁面。

      前往「應用程式」

    2. 在「應用程式」頁面中，找出應用程式名稱，然後從「ID」欄取得應用程式的 ID。

  2. 呼叫 engines.servingConfigs.search 方法，並為 search_type 指定 1。根據查詢內容是文字還是圖片位元組，選擇方法語法。

    查詢是文字字串

    curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_config:search" \
-d '{
"servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
"query": "QUERY",
"pageSize": "PAGE_SIZE",
"offset": "OFFSET",
"params": {"search_type": 1}
}'

    查詢內容為圖片

    curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
-d '{
"servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
"imageQuery": {"imageBytes":"IMAGE_BYTES"},
"pageSize": "PAGE_SIZE",
"offset": "OFFSET",
"params": {"search_type": 1}
}'

    更改下列內容：

    • PROJECT_ID：專案 ID。

    • APP_ID：應用程式 ID。

    • QUERY：搜尋查詢文字。例如「圓形頭燈車輛」或「顯示條紋洋裝」。

    • IMAGE_BYTES：採用 Base64 編碼位元組的圖片。支援的格式包括 JPEG、PNG 和 BMP。

    • PAGE_SIZE：選用。搜尋傳回的結果數量。網站搜尋的預設值為 10。

      • 如果值小於 0，系統會產生錯誤。
      • 如果值超過 100，系統會將值設為 100。

    • OFFSET：選用。結果的起始索引。 預設值為 0。

      舉例來說，如果偏移值為 2，頁面大小為 10，系統會傳回結果 2 到 11。

  3. 查看回覆。請參閱下表瞭解欄位說明：

    欄位 說明
    title 包含圖片的網頁純文字標題
    htmlTitle 包含圖片的網頁標題 (HTML 格式)
    displayLink 這項搜尋的結果網址縮寫版，通常是網域名稱，例如 www.example.com
    link 圖片的網址
    image.contextLink 內容連結：指向包含圖片的網頁網址
    image.byteSize 圖片大小 (以位元組為單位)
    image.width 圖片寬度 (以像素為單位)
    image.height 圖片高度 (以像素為單位)
    image.thumbnailWidth 縮圖的寬度 (以像素為單位)
    image.thumbnailHeight 縮圖的高度 (以像素為單位)
    image.thumbnailLink 縮圖網址
    mime 圖片的 MIME 類型
    fileFormat 圖片的檔案格式