Rechercher des images sur des sites Web

Avec Vertex AI Search, vous pouvez rechercher des images à l'aide d'une application avec des données de site Web. Vous fournissez une requête sous la forme d'une chaîne de texte ou d'une image, et la méthode default_config.search renvoie des images pour cette requête.

Avant de commencer

Assurez-vous de remplir les conditions préalables suivantes. Les exigences varient selon que vous effectuez une recherche à l'aide d'une requête textuelle ou d'une requête d'image.

Pour utiliser la ligne de commande afin de prévisualiser les résultats d'images pour un site Web, utilisez la méthode engines.servingConfigs.search :

  1. Trouvez l'ID de votre application. Si vous avez déjà votre ID d'application, passez à l'étape suivante.

    1. Dans la console Google Cloud , accédez à la page AI Applications.

      Accédez à "Applications".

    2. Sur la page Applications, recherchez le nom de votre application et récupérez son ID dans la colonne ID.

  2. Appelez la méthode engines.servingConfigs.search en spécifiant 1 pour search_type. Choisissez la syntaxe de la méthode selon que votre requête est du texte ou des octets d'image.

    La requête est une chaîne de texte.

    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 requête est une image

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

    Remplacez les éléments suivants :

    • PROJECT_ID : par l'ID du projet.

    • APP_ID : ID de votre application.

    • QUERY : texte de la requête de recherche. Par exemple, "Voitures avec phares ronds" ou "montre-moi une robe à rayures".

    • IMAGE_BYTES : image en octets encodés en base64. Les formats acceptés sont JPEG, PNG et BMP.

    • PAGE_SIZE : Facultatif. Nombre de résultats renvoyés par la recherche. La valeur par défaut est de 10 pour la recherche sur le site Web.

      • Les valeurs inférieures à 0 génèrent une erreur.
      • Les valeurs supérieures à 100 sont définies sur 100.

    • OFFSET : Facultatif. Index de départ des résultats. La valeur par défaut est 0.

      Par exemple, si le décalage est de 2 et la taille de la page de 10, les résultats 2 à 11 sont renvoyés.

  3. Vérifiez la réponse. Consultez le tableau suivant pour obtenir la description des champs :

    Champ Description
    title Titre en texte brut de la page Web contenant l'image
    htmlTitle Titre, en HTML, de la page Web contenant l'image
    displayLink Version abrégée de l'URL du résultat de recherche, généralement le nom de domaine (par exemple, www.example.com)
    link URL de l'image
    image.contextLink Lien de contexte : URL pointant vers la page Web contenant l'image
    image.byteSize Taille de l'image, en octets
    image.width Largeur de l'image, en pixels
    image.height Hauteur de l'image, en pixels
    image.thumbnailWidth Largeur de la miniature, en pixels
    image.thumbnailHeight Hauteur de la miniature, en pixels
    image.thumbnailLink URL de la vignette
    mime Type MIME de l'image
    fileFormat Format de fichier de l'image