必应图像搜索 API 的终结点

警告

2020 年 10 月 30 日，必应搜索 API 从 Azure AI 服务迁移到必应搜索服务。 本文档仅供参考。 有关更新的文档，请参阅必应搜索 API 文档。 关于为必应搜索创建新的 Azure 资源的说明，请参阅通过 Azure 市场创建必应搜索资源。

图像搜索 API 包括 3 个终结点。 终结点 1 基于查询返回来自 Web 的图像。 终结点 2 返回 ImageInsights。 终结点 3 返回热门图像。

终结点

若要使用必应 API 获取图像结果，请向以下某个终结点发送请求。 使用标头和 URL 参数来定义更多规范。

终结点 1：返回与 ?q="" 定义的用户搜索查询相关的图像。

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

终结点 2：使用有关 GET 或 POST 返回关于图像的见解。

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

GET 请求返回有关图像的见解，例如包含图像的网页。 包括 insightsToken 参数与 GET 请求。

或者，你可以在 POST 请求的正文中包含二进制图像，并将 modules 参数设置为 RecognizedEntities。 这将返回 insightsToken，用作后续 GET 请求中的参数，该参数返回图像中的有关人的信息。 将 modules 设置为 All 获取所有见解（POST 的结果中的 RecognizedEntities 除外），无需使用 insightsToken 进行其他调用。

终结点 3：基于其他人的搜索请求返回热门图像。 这些图像被分成不同类别，例如，基于值得注意的人或事件。

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

有关支持热门图像的市场列表，请参阅热门图像。

有关标头、参数、市场代码、响应对象、错误等详细信息，请参阅必应图像搜索 API v7 参考。

响应 JSON

对图像搜索请求的响应包括作为 JSON 对象的结果。 有关分析结果的示例，请参阅教程和源代码。

后续步骤

必应 API 支持根据其类型返回结果的搜索操作。 所有搜索终结点均将结果作为 JSON 响应对象返回。  所有终结点支持后列查询：按经度、纬度和搜索半径返回特定语言和/或位置的查询。

若要完整了解每个终结点支持的参数，请参阅每种类型对应的参考页面。 有关使用图像搜索 API 的基本请求的示例，请参阅图像搜索快速入门。