Points de terminaison pour l’API Recherche d’images Bing

  • Article

Avertissement

Le 30 octobre 2020, les API de recherche Bing sont passées des services Azure AI aux services de recherche Bing. Cette documentation est fournie à des fins de référence uniquement. Pour accéder à la documentation mise à jour, consultez la documentation de l’API Recherche Bing. Pour obtenir des instructions sur la création de nouvelles ressources Azure pour Recherche Bing, consultez Créer une ressource Recherche Bing à l’aide de Place de marché Azure.

L’API Recherche d’images inclut trois points de terminaison. Le point de terminaison 1 renvoie des images du Web grâce à une requête. Le point de terminaison 2 renvoie les informations ImageInsights. Le point de terminaison 3 renvoie des images populaires.

Points de terminaison

Pour obtenir des résultats d’images à l’aide de l’API Bing, envoyez une requête à l’un des points de terminaison suivants. Utilisez les en-têtes et les paramètres d’URL pour définir d’autres spécifications.

Point de terminaison 1 : renvoie des images qui sont pertinentes dans le cadre de la requête de recherche de l’utilisateur définie par ?q="".

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search

Point de terminaison 2 : renvoie des informations à propos d’une image, à l’aide des requêtes GET ou POST.

 GET or POST https://api.cognitive.microsoft.com/bing/v7.0/images/details

Une requête GET renvoie des informations à propos d’une image, comme les pages Web où figure l’image. Intégrez le paramètre insightsToken avec une requête GET.

Vous pouvez aussi inclure une image binaire dans le corps d’une requête POST et définir le paramètre de modules sur RecognizedEntities. Cette opération renvoie un jeton insightsToken à utiliser en tant que paramètre dans une requête GET ultérieure afin de récupérer des informations sur les personnes de l’image. Définissez modules sur All pour obtenir toutes les informations, hormis RecognizedEntities dans les résultats de la requête POST, sans avoir à effectuer d’autres appels via insightsToken.

Point de terminaison 3 : renvoie des images qui sont populaires en fonction des requêtes de recherche effectuées par d’autres utilisateurs. Les images sont séparées en différentes catégories, par exemple par personnes célèbres ou événements.

GET https://api.cognitive.microsoft.com/bing/v7.0/images/trending

Pour obtenir la liste des marchés sur lesquels les images populaires sont prises en charge, consultez Images populaires.

Pour plus d’informations sur les en-têtes, les paramètres, les codes de marché, les objets de réponse, les erreurs, etc., consultez la référence Bing Image Search API v7 (API Recherche d’images Bing v7).

Réponse JSON

La réponse à une requête de recherche d’images intègre les résultats sous forme d’objets JSON. Pour obtenir des exemples d’analyse des résultats, consultez le didacticiel et le code source.

Étapes suivantes

Les API Bing prennent en charge les actions de recherche qui renvoient des résultats en fonction de leur type.  Tous les points de terminaison de recherche renvoient des résultats en tant qu’objets de réponse JSON.  Tous les points de terminaison prennent en charge les requêtes qui renvoient une langue et/ou un emplacement spécifique par longitude, latitude et rayon de recherche.

Pour plus d’informations sur les paramètres pris en charge par chaque point de terminaison, consultez les pages de référence pour chaque type. Pour obtenir des exemples de requêtes de base à l’aide de l’API Recherche d’images, consultez les guides de démarrage rapide sur la recherche d’images.