Cómo buscar imágenes en sitios web

Con Vertex AI Search, puedes buscar imágenes con una app que tenga datos de sitios web. Proporcionas una búsqueda en forma de cadena de texto o imagen, y el método default_config.search devuelve imágenes para esa búsqueda.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos. Los requisitos varían según si realizas la búsqueda con una consulta de texto o una consulta de imagen.

Para usar la línea de comandos y obtener una vista previa de los resultados de imágenes de un sitio web, usa el método engines.servingConfigs.search:

  1. Busca el ID de tu app. Si ya tienes el ID de tu app, ve al siguiente paso.

    1. En la consola de Google Cloud , ve a la página AI Applications.

      Ve a Apps.

    2. En la página Apps, busca el nombre de tu app y obtén su ID en la columna ID.

  2. Llama al método engines.servingConfigs.search y especifica 1 para search_type. Elige la sintaxis del método según si tu búsqueda es de texto o de bytes de imagen.

    La consulta es una cadena de texto.

    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}
}'

    La búsqueda es una imagen

    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}
}'

    Reemplaza lo siguiente:

    • PROJECT_ID: el ID de tu proyecto.

    • APP_ID: Es el ID de tu app.

    • QUERY: Es el texto de la búsqueda. Por ejemplo, "Autos con faros redondos" o "Muéstrame vestidos con rayas".

    • IMAGE_BYTES: Es la imagen en bytes codificados en Base64. Los formatos admitidos son JPEG, PNG y BMP.

    • PAGE_SIZE: es opcional. Es la cantidad de resultados que devuelve la búsqueda. El valor predeterminado es 10 para la búsqueda en sitios web.

      • Los valores inferiores a 0 generan un error.
      • Los valores superiores a 100 hacen que el valor se establezca en 100.

    • OFFSET: es opcional. Es el índice inicial de los resultados. El valor predeterminado es 0.

      Por ejemplo, si el desplazamiento es 2 y el tamaño de la página es 10, se devuelven los resultados del 2 al 11.

  3. Revisa la respuesta. Consulta la siguiente tabla para obtener descripciones de los campos:

    Campo Descripción
    title El título de texto sin formato de la página web que contiene la imagen
    htmlTitle Título, en HTML, de la página web que contiene la imagen
    displayLink Es una versión abreviada de la URL del resultado de esta búsqueda, que suele ser el nombre de dominio (por ejemplo, www.example.com).
    link La URL de la imagen
    image.contextLink Vínculo contextual: Es una URL que dirige a la página web que contiene la imagen.
    image.byteSize Tamaño de la imagen en bytes
    image.width Ancho de la imagen, en píxeles
    image.height Altura de la imagen en píxeles
    image.thumbnailWidth Ancho de la imagen en miniatura, en píxeles
    image.thumbnailHeight Altura de la imagen en miniatura, en píxeles
    image.thumbnailLink Es la URL de la imagen en miniatura.
    mime Tipo de MIME de la imagen
    fileFormat Formato de archivo de la imagen