在网站上搜索图片

借助 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 图片的文件格式