你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

图像搜索 API v7 参考

警告

必应搜索 API 将从认知服务迁移到必应搜索服务。 从 2020 年 10 月 30 日开始,必应搜索的任何新实例都需按照此处所述的过程进行预配。 使用认知服务进行预配的必应搜索 API 将在未来三年或在企业协议结束前(以先发生者为准)得到支持。 有关迁移说明,请参阅必应搜索服务

使用图像搜索 API 可以发送搜索查询以必应并返回相关图像的列表。 本部分提供有关用于请求图像及其包含它们的 JSON 响应对象的查询参数和标头的技术详细信息。 有关如何发出请求的示例,请参阅 “搜索 Web 查找图像”。

有关请求应包含的标头的信息,请参阅 请求标头

有关请求应包含的查询参数的信息,请参阅 查询参数

有关响应可能包含的 JSON 响应对象的信息,请参阅 响应对象

有关允许使用和显示结果的信息,请参阅必应搜索 API 使用和显示要求

注意

由于 URL 格式和参数可能会在未另行通知的情况下有所更改,请按现状使用所有 URL。 不应依赖于 URL 格式或参数,除非另有说明。

终结点

若要请求映像,请将 GET 请求发送到以下 URL 之一:

终结点 说明
https://api.cognitive.microsoft.com/bing/v7.0/images/search 返回与用户搜索查询相关的图像。
https://api.cognitive.microsoft.com/bing/v7.0/images/details 返回有关图像的见解,例如包含图像的网页。
https://api.cognitive.microsoft.com/bing/v7.0/images/trending 基于其他人的搜索请求返回热门图像。 图像分为不同的类别。 例如,热门人员搜索。

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

对于多服务订阅,必须在 URL 中包含该区域。 例如:westus.api.cognitive.microsoft.com。 请参阅支持的区域

请求必须使用 HTTPS 协议。

注意

最大 URL 长度为 2,048 个字符。 为了确保 URL 长度不超出限制,查询参数的最大长度应不到 1,500 个字符。 如果 URL 超出 2,048 个字符,服务器会返回“404 未找到”。

标头

下面是请求和响应可能包含的标头。

标头 说明
Accept 可选请求标头。

默认的媒体类型为“application/json”。 若要指定响应使用 JSON-LD,请将 Accept 标头设置为“application/ld+json”。
Accept-Language 可选请求标头。

以逗号分隔的语言列表,用于用户界面字符串。 此列表以降序方式显示首选项。 有关详细信息,包括预期格式,请参阅 RFC2616

此标头和 setLang 查询参数相互排斥,不可同时指定两者。

如果设置此标头,则还必须指定 cc 查询参数。 为了确定针对哪个市场返回结果,必应使用从列表中找到的第一个受支持语言并将其与 cc 参数值相结合。 如果列表不包括支持的语言,必应会查找最接近的语言和支持请求的市场,或将聚合或默认市场用于结果。 若要确定必应使用的市场,请查看 BingAPIs-Market 标头。

仅当指定多个语言时,才可使用此标头和 cc 查询参数。 否则,请使用 mktsetLang 查询参数。

用户界面字符串是用作用户界面中标签的字符串。 JSON 响应对象中有几个用户界面字符串。 响应对象中 Bing.com 属性的任何链接均将应用指定的语言。
BingAPIs-Market 响应标头。

请求使用的市场。 形式为 <languageCode>-<countryCode>。 例如,en-US。

如果指定市场 代码中未列出的市场,此值可能与 mkt 查询参数中指定的市场不同。 如果为 无法协调的 ccAccept-Language 指定值,则也是如此。
BingAPIs-TraceId 响应标头。

包含请求详细信息的日志条目 ID。 发生错误时,捕获此 ID。 如果无法确定并解决问题,请纳入此 ID 以及提供给支持团队的其他信息。
Content-Type 可选请求标头。

如果将 模块 查询参数设置为 RecognizedEntities,则可以在 POST 请求正文中指定图像的二进制文件。 如果在 POST 请求正文中指定图像,则必须指定此标头并将其值设置为多部分/表单数据。

最大图像大小为 1 MB。
Ocp-Apim-Subscription-Key 必需请求标头。

认知服务中注册此服务时收到的订阅密钥。
Pragma 可选请求标头

默认情况下,必应返回缓存的内容(如果适用)。 若要防止缓存内容,请将 Pragma 标头设置为 no-cache (,例如 Pragma:no-cache) 。
Retry-After 响应标头。

如果超出 QPS) 或每月 ( (QPM) 允许的查询数,则响应将包含此标头。 标头包含在发送另一个请求之前必须等待的秒数。
User-Agent 可选请求标头。

发出请求的用户代理。 必应使用用户代理为移动用户提供优化体验。 尽管是可选的,但还是建议始终指定此标头。

user-agent 应该是任何常用浏览器发送的字符串。 有关用户代理的信息,请参阅 RFC 2616

下面是 user-agent 字符串示例。
  • Windows Phone - Mozilla/5.0(兼容;MSIE 10.0;Windows Phone 8.0;Trident/6.0;IEMobile/10.0;ARM;Touch;NOKIA;Lumia 822)

  • Android - Mozilla/5.0(Linux;U;Android 2.3.5;en-us;SCH-I500 Build/GINGERBREAD)AppleWebKit/533.1(KHTML,如 Gecko)版本/4.0 Mobile Safari/533.1

  • iPhone - Mozilla/5.0(iPhone;CPU iPhone OS 6_1,如 Mac OS X)AppleWebKit/536.26(KHTML;如 Gecko)Mobile/10B142 iPhone4;1 BingWeb/3.03.1428.20120423

  • PC - Mozilla/5.0(Windows NT 6.3;WOW64;Trident/7.0;Touch;rv:11.0),如 Gecko

  • iPad - Mozilla/5.0(iPad;CPU OS 7_0,如 Mac OS X)AppleWebKit/537.51.1(KHTML,如 Gecko)版本/7.0 Mobile/11A465 Safari/9537.53
X-MSEdge-ClientID 可选请求和响应标头。

必应使用此标头跨必应 API 调用为用户提供一致的行为。 必应通常会发布新功能和改进,并将客户端 ID 用作密钥以在不同航班上分配客流量。 如果未跨多个请求将相同的客户端 ID 用于用户,则必应可能将用户分配给多个冲突的航班。 分配给多个冲突航班可能导致用户体验不一致。 例如,如果第二个请求与第一个请求的航班分配不同,体验可能会出现意外。 此外,必应可以使用客户端 ID 为该客户端 ID 的搜索历史记录定制 Web 结果,从而为用户提供更丰富的体验。

通过分析由客户端 ID 生成的活动,必应还会使用此标头来提高结果排名。 相关改进有助于提高必应 API 交付的结果质量,从而提高 API 客户的点击率。

重要提示:尽管是可选的,但应将此标头视为必选。 对于同一最终用户和设备组合,如果跨多个请求保留客户端 ID,则 1) API 客户可以获取一致的用户体验;2) 可通过必应 API 提高结果质量,从而提高点击率。

下面是适用于此标头的基本用法规则。
  • 在设备上使用你的应用程序的每个用户必须具有必应生成的唯一客户端 ID。

    如果未在请求中包含此标头,必应会生成 ID,然后在 X-MSEdge-ClientID 响应标头中将其返回。 仅当用户首次在设备上使用应用时,才不可以在请求中包含此标头。

  • 注意:必须确保此客户端 ID 不能链接到任何可以进行身份验证的用户帐户信息。

  • 针对应用为设备上的此用户生成的每个必应 API 请求,使用客户端 ID。

  • 保留客户端 ID。 若要在浏览器应用中保留 ID,请使用持久性 HTTP Cookie 来确保所有会话均使用此 ID。 请勿使用会话 Cookie。 对于移动应用等其他应用,请使用设备的持久存储来保留 ID。

    下次用户在该设备上使用你的应用时,会获取保留的客户端 ID。

注意:必应响应不一定包含此标头。 如果响应包含此标头,请针对该设备上的用户捕获客户端 ID 并将其用于所有后续必应请求。

注意:如果包含 X-MSEdge-ClientID,不可在请求中包含 Cookie。
X-MSEdge-ClientIP 可选请求标头。

客户端设备的 IPv4 或 IPv6 地址。 IP 地址用于发现用户的位置。 必应使用位置信息来确定安全搜索行为。

注意:尽管是可选的,但还是建议始终指定此标头和 X-Search-Location 标头。

不要混淆地址(例如,通过将最后一个八位字节更改为 0 来混淆地址)。 混淆地址会导致位置未处于设备实际位置附近,这可能导致必应提供错误的结果。
X-Search-Location 可选请求标头。

以分号分隔的键/值对列表,描述客户端的地理位置。 必应使用位置信息来确定安全搜索行为并返回相关的本地内容。 以 <键>:<值> 形式指定键/值对。 下面是用于指定用户位置的键。

  • lat - 必需。 客户位置的纬度,以度为单位。 纬度必须大于或等于 -90.0 且小于或等于 +90.0。 负值表示南纬,正值表示北纬。

  • long - 必需。 客户位置的经度,以度为单位。 经度必须大于或等于 -180.0 且小于或等于 +180.0。 负值表示西经,正值表示东经。

  • re - 必需。 半径(以米为单位),指定坐标的水平准确性。 传递设备定位服务返回的值。 典型的值可能是:22m - GPS/Wi-Fi、380m - 蜂窝基站三角网定位、18,000m - 反向 IP 查询。

  • ts - 可选。 客户位于相应位置时的 UTC UNIX 时间戳。 (UNIX 时间戳是自 1970 年 1 月 1 日起的秒数。)

  • head - 可选。 客户端的相对航向或旅行方向。 以度数指定旅行方向(从 0 到 360),相对于正北方向顺时针计数。 如果 sp 键为非零值,则指定此键。

  • sp - 可选。 客户设备移动的水平速度(速度),以米/秒为单位。

  • alt - 可选。 客户设备的高度,以米为单位。

  • are - 可选。 半径(以米为单位),指定坐标的垂直准确度。 只有在指定 alt 键的情况下才指定此键。

  • disp - 可选。 用户的地理位置,格式为 disp:<City,State>。 例如,disp:Seattle、Washington。 这是使用 lat/long 键指定的用户位置的显示文本版本。 如果此值与 lat/long 坐标冲突,必应使用 disp 值作为用户的位置。

注意:如果查询包含位置,则必应忽略此标头。 例如,如果此标头反映用户作为旧金山的位置,但查询是西雅图餐厅,必应返回位于华盛顿西雅图的餐馆。

注意:尽管许多键是可选的,但提供的信息越多,位置结果越精确。

注意:尽管是可选的,但还是建议始终指定用户的地理位置。 如果客户端的 IP 地址未准确反映用户的物理位置(例如,如果客户端使用 VPN),则提供位置尤其重要。 为了获得最佳结果,应包含此标头和 X-Search-ClientIP 标头,但至少应包含此标头。

注意

请记住,使用条款要求遵守所有适用的法律,包含这些标头的用法。 例如,在某些管辖区(如欧洲),在用户设备上放置某些跟踪设备之前,需要获得用户同意。

查询参数

下面是请求可能包含的查询参数。 请查看所需参数的“必需”列。 必须对查询参数值进行 URL 编码。 有关用于筛选必应返回的图像的查询参数的信息,请参阅“筛选查询参数”。

名称 类型 必需
出租车 要裁剪的区域的底部坐标。

坐标是原始图像高度的分数值,从图像的左上角测量。 将坐标指定为 0.0 到 1.0 的值。

仅对 Insights API 使用此参数。 调用图像、趋势图像或 Web 搜索 API 时,请勿指定此参数。
Float
卡尔 要裁剪的区域的左坐标。

坐标是原始图像宽度的一小部分,从图像的左上角测量。 将坐标指定为从 0.0 到 1.0 的值。

仅对 Insights API 使用此参数。 调用图像、趋势图像或 Web 搜索 API 时,请勿指定此参数。
Float
要裁剪的区域的正确坐标。

坐标是原始图像宽度的一小部分,从图像的左上角测量。 将坐标指定为从 0.0 到 1.0 的值。

仅对 Insights API 使用此参数。 调用图像、趋势图像或 Web 搜索 API 时,请勿指定此参数。
Float
要裁剪的区域的顶部坐标。

坐标是原始图像的高度的一小部分,是从图像的左上角测量的。 将坐标指定为从 0.0 到 1.0 的值。

仅对 Insights API 使用此参数。 调用图像、趋势图像或 Web 搜索 API 时,请勿指定此参数。
Float
Ct 根据 中指定的calcatcar坐标和cab参数裁剪图像时要使用的裁剪类型。

下面是可能的值。
  • 0 — 矩形 (默认)

仅对 Insights API 使用此参数。 调用图像、趋势图像或 Web 搜索 API 时,请勿指定此参数。
无符号整数
cc 结果来源的国家/地区的 2 个字符国家/地区代码。 有关可能值的列表,请参阅 市场代码

如果设置此参数,则还必须指定 Accept-language 标头。 必应使用指定语言中查找的第一种受支持语言,并将其与国家/地区代码相结合,以确定市场以返回结果。 如果语言列表不包括支持的语言,必应会查找最接近的语言和支持请求的市场。 或者,必应可能会对结果使用聚合市场或默认市场。

仅当指定多种语言时,才使用此查询参数和 Accept-Language 标头。 否则,应使用 mktsetLang 查询参数。

此参数和 mkt 查询参数相互排斥,不可同时指定两者。
String
count 响应中要返回的图像数。 提供的实际结果数可能小于请求获取的结果数。 默认值为 35。 最大值为 150。

将此参数与参数一起使用 offset 来页结果。 例如,如果用户界面显示每页 20 张图像,则设置为 count 20 和 offset 0,以获取结果的第一页。 对于每个后续页面,递增 offset 20 (,例如 0、20、40) 。

仅将此参数用于图像搜索 API。 调用Insights、趋势图像或 Web 搜索 API 时,请勿指定此参数。
UnsignedShort
id 唯一标识图像的 ID。 使用此参数可确保指定的图像是必应返回的图像列表中的第一个图像。 Image 对象的imageId字段包含将此参数设置为的 ID。 String
imgUrl 要获取见解的图像的 URL。 使用此参数作为使用参数指定图像的替代 insightsToken 方法。 还可以通过将图像的二进制文件放置在 POST 请求的正文中来指定映像。 如果使用二进制选项,请参阅 Content-Type 标头。

受支持的最大图像大小为 1 MB。

仅对 Insights API 使用此参数。 调用图像、趋势图像或 Web 搜索 API 时,请勿指定此参数。
String
insightsToken 映像令牌。 Image 对象的 imageInsightsToken 包含令牌。 指定此参数以获取有关图像的其他信息,例如标题或购物源。 有关可以获取的图像的其他信息的列表,请参阅 模块 查询参数。

仅对 Insights API 使用此参数。 调用图像、趋势图像或 Web 搜索 API 时,请勿指定此参数。
String
mkt 产生结果的市场。 通常, mkt 是用户发出请求的国家/地区。 但是,如果用户不在必应提供结果的国家/地区,则可能是不同的国家/地区。 市场必须采用语言代码国家/地区代码><>的形式。< 例如,en-US。 字符串不区分大小写。 有关可能的市场值的列表,请参阅 市场代码

注意: 如果已知,建议始终指定市场。 指定市场有助于必应路由请求,并返回适当的最佳响应。 如果指定市场代码中未列出的市场,则必应根据要更改的内部映射使用最适合的市场代码。

此参数和 cc 查询参数相互排斥,不可同时指定两者。
String
模块 要请求的见解的逗号分隔列表。 下面是可能的不区分大小写的值。
  • All - 返回除 RecognizedEntities 之外的所有见解(如果有)。

  • BRQ — 最佳代表性查询。 最能描述图像的查询词。

  • 标题 - 提供有关图像信息的标题。 如果标题包含实体,响应可能包含指向这些实体图像的链接。

  • 集合 - 相关图像的列表。

  • 食谱 - 用于烹饪图像中显示的食物的食谱列表。
  • PagesIncluding - 包含图像的网页列表。

  • RecognizedEntities - 图像中识别的实体列表 (人员) 。

    注意: 不能使用任何其他模块指定此模块。 如果使用其他模块指定它,则响应不包括已识别的实体。

  • RelatedSearches - 其他人进行的相关搜索列表。

  • ShoppingSources - 可在其中购买相关产品/服务的商家列表。

  • SimilarImages - 视觉上类似于原始图像的图像列表。

  • SimilarProducts - 包含与原始图像中找到的产品类似的产品的图像列表。

  • 标记 - 提供图像中找到的内容类型的特征。 例如,如果图像是某个人,标记可能会指示该人的性别和所穿的衣服类型。

如果指定模块且模块没有数据,则响应对象不包括相关字段。 例如,如果指定 Caption 且不存在,则响应不包含该 imageCaption 字段。

若要包含相关搜索,请求必须包含原始查询字符串。

尽管类似图像或产品不需要原始查询字符串,但应始终包含它,因为它可以帮助提高相关性和结果。

仅对 Insights API 使用此参数。 调用图像、趋势图像或 Web 搜索 API 时,请勿指定此参数。
String
offset 从零开始的偏移量,指示在返回图像之前要跳过的图像数。 默认值为 0。 偏移量应小于 (totalEstimatedMatches - count) 。

若要页结果,请使用此参数和 count 参数。 例如,如果用户界面显示每页 20 张图像,则设置为 count 20 和 offset 0,以获取结果的第一页。 对于每个后续页面,递增 offset 20 (,例如 0、20、40) 。

多个页面可以在结果中包含一些重叠。 若要防止重复,请参阅 nextOffset

仅将此参数用于图像 API。 调用趋势图像 API 或 Web 搜索 API 时,请勿指定此参数。
未签名的短
q 用户的搜索查询词。 术语不能为空。

术语可能包含必应高级运算符。 例如,若要将图像限制为特定域,请使用 站点: 运算符。

为了帮助提高见解查询的相关性, (查看 insightsToken) ,应始终包含用户的查询词。

仅将此参数用于图像搜索 API。 调用趋势图像 API 时,请勿指定此参数。
String
safeSearch 筛选成人内容的图像。 下面是可能的筛选器值。
  • 关闭 - 可能会返回包含成人内容的图像。 如果请求通过图像搜索 API,则响应包含 (非模糊) 的缩略图。 但是,如果请求通过 Web 搜索 API,响应将包含像素化 (模糊) 的缩略图。

  • 中等 - 如果请求是通过图像搜索 API,则响应不包括包含成人内容的图像。 如果请求通过 Web 搜索 API,响应可能包含成人内容的图像, (缩略图图像 (模糊) ) 像素化。

  • 严格 - 不要返回包含成人内容的图像。

默认级别为“中等”。

注意:如果请求来自必应成人策略要求将 safeSearch 设置为“严格”的某一市场,必应会忽略 safeSearch 值并使用“严格”。

注意:如果使用 site: 查询运算符,则不管 safeSearch 查询参数设置如何,仍有可能出现响应中包含成人内容的情况。 只有在知道网站内容且方案允许使用成人内容的情况下,才应使用 site:
字符串
setLang 可用于用户界面字符串的语言。 可以使用 2 个字母或 4 个字母代码指定语言。 首选使用 4 个字母代码。

有关受支持的语言代码列表,请参阅必应支持的语言

如果setlang包含有效的 2 个非特定区域性代码( (fr) )或 (fr-ca) 的有效 4 个字母特定区域性代码,则必应加载本地化字符串。 例如,对于 fr-ca,必应加载 fr 中性区域性代码字符串。

例如,如果setlang无效 (,则 zh) 或 必应 不支持语言 (,例如 af、af-na) ,必应默认为 en (英语) 。

若要指定 2 个字母代码,请将此参数设置为 ISO 639-1 语言代码。

若要指定 4 个字母代码,请使用语言<国家/地区>,其中<语言>><是 ISO 639-1 语言代码 (中性区域性) 和国家</地区是 ISO 3166 国家/>地区 (特定区域性) 代码。 例如,使用 en-US 进行英语美国。

尽管是可选项,但应始终指定语言。 通常情况下,请将 setLang 设置为 mkt 所指定的语言,除非用户希望以另一语言显示用户界面字符串。

此参数和 Accept-Language 标头相互排斥,不可同时指定两者。

用户界面字符串是用作用户界面中标签的字符串。 JSON 响应对象中有几个用户界面字符串。 此外,响应对象中 Bing.com 属性的任何链接均会应用指定的语言。
字符串

筛选查询参数

下面是可用于筛选必应返回的图像的可选筛选器查询参数。 必须对查询参数进行 URL 编码。

将这些参数仅用于图像搜索 API。 调用趋势图像 API 或 Web 搜索 API 时,请勿指定这些参数。

名称 类型
方面 按以下纵横比筛选图像:
  • 方形 - 返回具有标准纵横比的图像
  • 宽 - 返回具有宽屏幕纵横比的图像
  • 高 - 返回高纵横比的图像
  • 全部 - 不要按方面进行筛选。 指定此值与不指定 aspect 参数相同。
String
颜色 按以下颜色选项筛选图像:
  • ColorOnly - 返回颜色图像
  • 单色 - 返回黑白图像

返回具有以下主要颜色之一的图像:
  • 黑色
  • 蓝色
  • Brown
  • 灰色
  • 绿色
  • 橙色
  • 粉色
  • 紫色
  • Red
  • 青色
  • White
  • Yellow
String
新鲜 按以下发现选项筛选图像:
  • Day - 返回过去 24 小时内必应发现的图像
  • 周 - 返回过去 7 天内由必应发现的图像
  • 月份 - 返回过去 30 天内必应发现的图像
String
高度 筛选具有指定高度的图像(以像素为单位)。

可以将此筛选器与筛选器一起使用 size ,以返回高度为 150 像素的小图像。
UnsignedShort
imageContent 按以下内容类型筛选图像:
  • 人脸 - 返回仅显示人脸的图像
  • 纵向 - 返回仅显示一个人的头部和肩膀的图像
String
imageType 按以下图像类型筛选图像:
  • AnimatedGif - 返回动态 gif 图像

  • AnimatedGifHttps - 返回来自 https 地址的动态 gif 图像

  • 剪贴画 - 仅返回剪贴画图像

  • 线条 - 仅返回线条图

  • 照片 - 仅返回 (不包括线图、动画 gif 和剪贴画) 的照片

  • 购物 - 仅返回包含必应知道销售商品的商家的图像。 此选项仅在 en-US 市场中有效。

  • 透明 - 仅返回具有透明背景的图像。
String
许可证 按以下许可证类型筛选图像:
  • 任何 - 返回属于任何许可证类型的图像。 响应不包括未指定许可证或许可证未知的图像。

  • 公共 - 返回创建者在法律允许的最充分范围内放弃其独家权利的图像。

  • 共享 - 返回可能与其他人共享的图像。 可能不允许更改或编辑图像。 此外,不允许出于商业目的修改、共享和使用映像。 通常,此选项返回的图像最多。

  • ShareCommercially - 返回可能出于个人或商业目的与他人共享的图像。 可能不允许更改或编辑图像。

  • 修改 - 返回可以修改、共享和使用的图像。 可能不允许更改或编辑图像。 不得出于商业目的修改、共享和使用映像。

  • ModifyCommercially - 返回可用于个人或商业目的的修改、共享和使用的映像。 通常,此选项返回最少的图像。

  • 全部 - 不要按许可证类型进行筛选。 指定此值与不指定 license 参数相同。

有关这些许可证类型的详细信息,请参阅 按许可证类型筛选映像
String
maxFileSize 筛选小于或等于指定文件大小的图像。

可以指定的最大文件大小为 520,192 字节。 如果指定较大的值,API 将使用 520,192。 响应可能包含略大于指定最大值的图像。

可以指定此筛选器并 minFileSize 筛选文件大小范围内的图像。
Integer
maxHeight 筛选高度小于或等于指定高度的图像。 指定高度(以像素为单位)。

可以指定此筛选器并 minHeight 筛选高度范围内的图像。

此筛选器和 height 筛选器互斥。
Integer
maxWidth 筛选宽度小于或等于指定宽度的图像。 指定宽度(以像素为单位)。

可以指定此筛选器并 maxWidth 筛选宽度范围内的图像。

此筛选器和 width 筛选器互斥。
Integer
minFileSize 筛选大于或等于指定文件大小的图像。

可以指定的最大文件大小为 520,192 字节。 如果指定较大的值,API 将使用 520,192。 响应可能包含小于指定最小值的图像。

可以指定此筛选器并 maxFileSize 筛选文件大小范围内的图像。
Integer
minHeight 筛选高度大于或等于指定高度的图像。 指定高度(以像素为单位)。

可以指定此筛选器并 maxHeight 筛选高度范围内的图像。

此筛选器和 height 筛选器互斥。
Integer
minWidth 筛选宽度大于或等于指定宽度的图像。 指定宽度(以像素为单位)。

可以指定此筛选器并 maxWidth 筛选宽度范围内的图像。

此筛选器和 width 筛选器互斥。
Integer
大小 按以下大小筛选图像:
  • 小 - 返回小于 200x200 像素的图像

  • 中 - 返回大于或等于 200x200 像素但小于 500x500 像素的图像

  • 大 - 返回 500x500 像素或更大的图像

  • 壁纸 - 返回壁纸图像。

  • 全部 - 不要按大小进行筛选。 指定此值与不指定 size 参数相同。

可以将此参数与或width参数一起使用height。 例如,可以使用 heightsize 请求高 150 像素的小图像。
String
宽度 筛选具有指定宽度的图像(以像素为单位)。

可以将此筛选器与 size 筛选器结合使用,以返回宽度为 150 像素的小图像。
UnsignedShort

响应对象

注意

为了遵守法国新的欧盟版权指令,必应 Web、新闻、视频、图像和所有自定义搜索 API 必须省略来自法国用户某些欧盟新闻源的某些内容。 已删除的内容可能包括缩略图图像和视频、视频预览和附带这些源搜索结果的代码片段。 因此,必应 API 可能会为法国用户提供缩略图和视频、视频预览和代码片段来减少结果。

下面是响应可能包含的 JSON 对象。 如果请求成功,则响应中的顶级对象是 图像 对象(如果终结点为 /images/search, 则为 ImageInsightsResponse ;如果终结点为 /images/details,则为 TrendingImages ;如果终结点为 /images/trending)。 如果请求失败,则顶级对象为 ErrorResponse 对象。

对象 说明
AggregateOffer 定义与图像相关的商家的产品/服务列表。
AggregateRating 定义指示其他项对项的评分方式的指标。
类别 定义趋势图像的类别。
错误 定义发生的错误。
ErrorResponse 请求失败时响应包含的顶级对象。
图像 定义与查询相关的图像。
ImageCaption 定义图像的标题。
ImageGallery 定义包含相关图像集合的网页的链接。
ImageInsights 响应包含的顶级对象,当图像见解请求成功时。
映像 响应在图像请求成功时包括的顶级对象。
ImagesModule 定义图像列表。
ImageTagsModule 定义图像中找到的内容的特征。
InsightsMetadata 定义可在其中购物或执行与图像相关的其他操作的网站数的计数。
MediaSize 定义媒体内容的大小。
NormalizedRectangle 定义图像的区域。
检测 定义必应检测 URL。
产品/服务 定义商家的产品/服务。
组织 定义有关商家的信息。
Person 定义人员。
透视 定义透视段。
查询 定义搜索查询字符串。
配方 定义烹饪食谱。
RecipesModule 定义烹饪食谱的列表。
RecognizedEntity 定义识别的实体。
RecognizedEntityGroup 定义一组以前识别的实体。
RecognizedEntitiesModule 定义以前识别的实体的列表。
RecognizedEntityRegion 定义一个区域,其中找到了实体,以及可能与之匹配的实体列表。
RelatedCollectionsModule 定义指向包含相关图像的网页的链接列表。
RelatedSearchesModule 定义其他人进行的相关搜索列表。
标记 定义图像中找到的特征。
缩略 图 定义缩略图。
磁贴 定义图像磁贴。
TrendingImages 响应包含的趋势图像请求成功时的顶级对象。

AggregateOffer

定义与图像相关的商家的产品/服务列表。

元素 说明 类型
提供 具有与图像相关的产品/服务的商家的产品/服务列表。 Offer[]

AggregateRating

定义指示其他项对项的评分方式的指标。

名称 类型
bestRating 评价最高的评论。 可能的值为 1.0 到 5.0。 FLOAT
ratingValue 平均 (平均) 评级。 可能的值为 1.0 到 5.0。 FLOAT
reviewCount 食谱被分级或审查的次数。 无符号整数
text 平均 (平均) 分级,以字符串形式表示。 String

Category

定义趋势图像的类别。

元素 说明 类型
瓷砖 类别中趋势的图像列表。 每个磁贴都包含一个图像和一个 URL,该 URL 返回主题的更多图像。 例如,如果类别为“热门人脉搜索”,则图像为常用人员,URL 将返回该人员的更多图像。 Tile[]
标题 图像类别的名称。 例如,热门人员搜索。 String

错误

定义已发生的错误。

元素 说明 类型
code 用于标识错误类别的错误代码。 如需可能的代码的列表,请参阅错误代码 字符串
message 对错误的说明。 字符串
moreDetails 一个说明,提供关于错误的其他信息。 字符串
parameter 请求中导致错误的查询参数。 字符串
subCode 用于标识错误的错误代码。 例如,如果 code 为 InvalidRequest,则 subCode 可以为 ParameterInvalid 或 ParameterInvalidValue。 字符串
value 查询参数的无效值。 字符串

ErrorResponse

请求失败时响应包含的顶级对象。

名称 类型
_type 类型提示。 字符串
errors 错误的列表,用于说明请求失败原因。 Error[]

映像

定义与查询相关的图像。

注意

由于 URL 格式和参数可能随时更改,因此请按原样使用所有 URL。 不应依赖 URL 格式或参数。 例外是重 设大小和裁剪缩略图图像所讨论的参数和值。

名称 类型
accentColor 一个三字节十六进制数,表示主宰图像的颜色。 将颜色用作客户端中的临时背景,直到加载图像。 String
contentSize 图像的文件大小。 字符串的格式为 {size} {units}。 例如,12345 B 表示图像的大小为 12,345 字节。 String
contentUrl 源网站上的图像的 URL。 String
datePublished 必应发现图像的日期和时间(以 UTC 为单位)。 日期的格式为 YYYY-MM-DDTHH:MM:SS。 String
encodingFormat 图像的 mime 类型 (例如 jpeg) 。 String
高度 源图像的高度(以像素为单位)。 未签名的短
hostPageDisplayUrl 承载图像的网页的显示 URL。

在用户界面中使用此 URL 标识包含图像的主机网页。 URL 格式不正确,不应用于访问主机网页。 若要访问主机网页,请使用 hostPageUrl URL。
String
hostPageUrl 包含图像的网页的 URL。

此 URL 可能 contentUrl 相同。
String
id 唯一标识映像列表中的此映像的 ID。

只有 Web 搜索 API 响应才包含此字段。 有关如何使用此字段的信息,请参阅 使用排名在 Web 搜索 API 指南中显示结果。
String
imageId 唯一标识此映像的 ID。 如果希望映像是响应中的第一个映像,请将 ID 查询参数设置为请求中的此 ID。 String
imageInsightsToken 在随后调用图像搜索 API 时使用的令牌,以获取有关图像的其他信息。 有关使用此令牌的信息,请参阅 insightsToken 查询参数。 String
insightsMetadata 可以购物或执行与图像相关的其他操作的网站数的计数。

例如,如果图像是苹果饼,则此对象包含可以购买苹果饼的网站数的计数。 若要指示 UX 中的产品/服务数量,请包含错误,例如包含计数的购物车图标。 当用户单击图标时,用于 imageInisghtsToken 获取网站列表。
InsightsMetadata
名字 图像的标题。 String
缩略 图 缩略图的宽度和高度 () 。thumbnailUrl MediaSize
thumbnailUrl 图像缩略图的 URL。 有关调整图像大小的信息,请参阅 重设图像大小和裁剪缩略图图像 字符串
webSearchUrl 此图像必应搜索结果的 URL。 String
宽度 源图像的宽度(以像素为单位)。 未签名的短

ImageCaption

定义图像的标题。

名称 类型
标题 有关图像的标题。 String
dataSourceUrl 找到标题的网站的 URL。 必须将标题属性属性到源。 例如,通过显示标题旁边的 URL 中的域名,并使用 URL 链接到源网站。 String
relatedSearches 标题中找到的实体列表。 使用对象的内容 Query 在标题中查找实体并创建链接。 该链接将用户带到实体的图像。 查询

ImageGallery

定义包含相关图像集合的网页的链接。

名称 类型
创造者 拥有集合的人员。 必须将集合归因于创建者。 Person
描述 集合的说明。 说明可能为空。 String
followersCount 关注创建者的社交网络上的用户数。 无符号整数
imagesCount 集合中找到的相关图像数。 无符号整数
名字 库的名称。 String
在其中找到图像的发布者或社交网络。 必须将发布者归为找到集合的源。 String
thumbnailUrl 集合中找到的图像之一的缩略图的 URL。 String
Url 包含相关图像集合的网页的 URL。 String

ImageInsights

响应包含的顶级对象,当图像见解请求成功时。

有关请求图像见解的信息,请参阅 insightsToken 查询参数。

模块查询参数会影响响应中必应包括的字段。 如果仅设置为 modules Caption,则此对象仅 imageCaption 包含字段。

名称 类型
_type 类型提示,设置为 ImageInsights。 String
bestRepresentativeQuery 最能表示图像的查询词。 单击对象中的 Query 链接,将用户带到具有更多图像图片的网页。 查询
imageCaption 用于图像的标题。 ImageCaption
imageInsightsToken 在随后调用图像搜索 API 时使用的令牌,以获取有关图像的详细信息。 有关使用此令牌的信息,请参阅 insightsToken 查询参数。

此令牌的用法与 Image 对象中的令牌相同。
String
imageTags 图像中找到的内容的特征列表。 例如,如果图像是某个人的,标记可能会指示该人的性别和他们正在穿的衣服类型。 ImageTagsModule
pagesIncluding 包含图像的网页列表。 若要访问网页,请使用图像字段中的 hostPageUrl URL。 ImagesModule
recipes 与图像相关的食谱列表。 例如,如果图像是苹果饼,则列表包含用于制作苹果饼的食谱。 RecipesModule
recognizedEntityGroups 包含与指定映像中找到的实体匹配的实体图像的组列表。 例如,如果实体在该组中被识别,则响应可能包含来自常规名人组的图像。 RecognizedEntitiesModule
relatedCollections 包含相关图像的网页的链接列表。 RelatedCollectionsModule
relatedSearches 其他查询所做相关查询的列表。 RelatedSearchesModule
shoppingSources 提供与图像相关的项目的商家列表。 例如,如果图像是苹果饼,则列表包含销售苹果馅饼的商家。 AggregateOffer
visuallySimilarImages 视觉上类似于原始图像的图像列表。 例如,如果指定的图像是水体上的日落图像,则类似图像的列表在水体上是日落。

如果指定的图像是某个人,则类似的图像可能与同一个人,或者可能与身着相似或类似设置的人相称。

相似性的标准不断发展。
ImagesModule
visuallySimilarProducts 包含与原始图像中找到的产品相似的产品的图像列表。 例如,如果指定的图像包含连衣裙,则类似图像的列表包含一个连衣裙。

该图像提供有关产品联机找到必应产品/服务的摘要信息。
ImagesModule

映像

响应在图像请求成功时包括的顶级对象。

名称 类型
_type 类型提示,设置为图像。 String
id 唯一标识图像答案的 ID。

该对象仅在 Web 搜索 API 响应中包括此字段。 有关如何使用此字段的信息,请参阅 使用排名在 Web 搜索 API 指南中显示结果。
String
isFamilyFriendly 一个布尔值,该值确定一个或多个图像是否包含成人内容。 如果图像中没有包含成人内容, isFamilyFriendly 则设置为 true。 否则,如果一个或多个图像包含成人内容, isFamilyFriendly 则设置为 false

如果 为 false,则缩略图图像 (模糊) 进行像素化。

注意: 此字段仅包含在 Web 搜索 API 响应中,而不是图像搜索 API 响应中。
布尔
nextOffset 将偏移量查询参数设置为的 偏移 值。

如果在第一个请求中设置为 offset 0 和 count 30,然后在第二个请求中设置为 offset 30,则第二个响应中的一些结果可能是第一个响应的重复项。

若要防止重复项,请设置为 offsetnextOffset
Integer
pivotSuggestions 原始查询中的段列表。 例如,如果查询为红色花,必应可能会将查询细分为红色

花花透视可能包含查询建议,如红牡丹和红菊,红色透视可能包含查询建议,如绿花和黄色花。
透视
queryExpansions 扩展查询的列表,用于缩小原始查询的范围。 例如,如果查询是 Microsoft Surface,则扩展的查询可以是 Microsoft Surface Pro 3、Microsoft Surface RT、Microsoft Surface Phone 和 Microsoft Surface Hub 查询
readLink 返回此答案的 URL。 若要使用 URL,请根据需要追加查询参数,并包括 Ocp-Apim-Subscription-Key 标头。

Web 搜索 API 响应包括此字段。 通常,如果要直接查询图像搜索 API,请使用 URL。
String
similarTerms 类似于用户查询词的术语列表。 查询
totalEstimatedMatches 与查询相关的估计图像数。 将此数字与 计数偏移 查询参数一起使用,以便对结果进行分页。

只有图像搜索 API 包含此字段。
Long
value 与查询相关的图像列表。

如果没有结果,则数组为空。
Image[]
webSearchUrl 所请求图像的必应搜索结果的 URL。 String

ImagesModule

定义图像列表。

元素 说明 类型
value 图像列表。 Image[]

ImageTagsModule

定义图像中找到的内容的特征。

元素 说明 类型
value 描述图像中找到的内容特征的标记列表。 例如,如果图像是音乐艺术家,列表可能包括女性、礼服和音乐,以指示该人是穿着礼服的女性音乐艺术家。 Tag[]

InsightsMetadata

定义可以购物或执行与图像相关的其他操作的网站数的计数。

元素 说明 类型
aggregateOffer 图像中找到的产品的在线产品/服务摘要。 例如,如果图像是连衣裙,产品/服务可能会识别最低价格和找到的产品/服务数量。

只有视觉上类似的产品见解才包含此字段。

套餐包括以下字段:NameAggregateRating、和OfferCountLowPrice
产品/服务
recipeSourcesCount 提供图像中显示的食物食谱的网站数。 无符号整数
shoppingSourcesCount 提供图像中显示的产品商品的网站数。 无符号整数

MediaSize

定义媒体内容的大小。

名称 类型
高度 媒体内容的高度(以像素为单位)。 Integer
width 媒体内容的宽度(以像素为单位)。 Integer

NormalizedRectangle

定义图像的区域。 区域由该区域的上角、左下角和右下角的坐标定义。 坐标是原始图像宽度和高度在 0.0 到 1.0 范围内的分数值。

名称 类型
bottom 底部坐标。 Float
左侧 左侧坐标。 Float
正确的坐标 Float
top 顶部坐标 Float

产品/服务

定义商家的产品/服务。

ShoppingSources 见解和 SimilarProducts 见解都使用此对象。 若要确定字段适用的见解,请参阅字段的说明。

元素 说明 类型
aggregateRating 一个聚合分级,指示产品已受到其他人的评价。

SimilarProducts 使用。
AggregateRating
availability 项的可用性。 下面是可能的值。
  • 已中断
  • InStock
  • InStoreOnly
  • LimitedAvailability
  • OnlineOnly
  • OutOfStock
  • PreOrder
  • SoldOut

由 ShoppingSources 使用。
字符串
description 项的说明。 String
lastUpdated 产品/服务更新的最后一个日期。 日期采用 YYYY-MM-DD 格式。 刺痛
lowPrice 必应联机找到的项目的最低价格。

SimilarProducts 使用。
Float
name 产品的名称。 String
offerCount 必应联机找到的产品/服务数。

SimilarProducts 使用。
无符号整数
price 项目的价格。

由 ShoppingSources 使用。
Float
priceCurrency 货币。 例如,USD。 String
卖方 商家的姓名。

由 ShoppingSources 使用。
组织
url 商家网站上的产品/服务的 URL。

由 ShoppingSources 使用。
字符串

组织

定义有关商家的信息。

元素 说明 类型
image 商家的徽标。 该 Image 对象仅 url 包含字段。 图像
name 商家的姓名。 字符串

人员

定义人员。

名称 类型
_type 类型提示。 字符串
description 人员的简短描述。 String
image 人员的图像。 图像
jobTitle 该人员的职务。 String
name 人员的姓名。 String
twitterProfile 人员的 Twitter 个人资料的 URL。 字符串
url 人员社交网络主页的 URL(如果适用)。 字符串
webSearchUrl 必应搜索结果页的 URL,其中包含有关此人的信息。 String

透视

定义透视段。

名称 类型
支点 要透视的原始查询中的段。 String
建议 针对透视的建议查询的列表。 查询

查询

定义搜索查询字符串。

名称 类型
displayText 查询词的显示版本。

有关展开的查询 (请参阅 queryExpansions) 和数据透视建议, (查看 pivotSuggestions) ,此字段标识扩展原始查询的术语。 例如,如果查询是 Microsoft Surface ,而展开的查询是 Microsoft Surface RTdisplayText 则包含 RT
String
searchLink 用于获取相关搜索结果的 URL。 使用 URL 之前,必须根据需要追加查询参数,并包括 Ocp-Apim-Subscription-Key 标头。

如果要在自己的用户界面中显示结果,请使用此 URL。 否则,请使用 webSearchUrl URL。
字符串
text 查询词。 String
thumbnail 相关图像缩略图的 URL。

该对象仅包含透视建议和相关搜索的此字段。
缩略 图
webSearchUrl 将用户带到查询的必应搜索结果页的 URL。

如果未在自己的用户界面中显示结果,请使用此 URL。 否则,请使用 searchUrl URL。

仅包含相关搜索。
String

配方

定义烹饪食谱。

元素 说明 类型
aggregateRating 聚合评级,指示食谱是如何被其他人评级的。 AggregateRating
cookTime 食物需要煮熟的时间。 例如,PT25M。 有关时间格式的信息,请参阅 https://en.wikipedia.org/wiki/ISO_8601#Durations String
创造者 食谱的作者。 Person
name 食谱的名称。 String
prepTime 准备成分所需的时间。 例如,PT15M。 有关时间格式的信息,请参阅 https://en.wikipedia.org/wiki/ISO_8601#Durations String
thumbnailUrl 已准备食品缩略图的 URL。 String
totalTime 准备和烹饪食谱所需的时间总量。 例如,PT45M。 有关时间格式的信息,请参阅 https://en.wikipedia.org/wiki/ISO_8601#Durations 字符串
url 将用户带到包含食谱的网页的 URL。 String

RecipesModule

定义食谱列表。

元素 说明 类型
value 食谱列表。 食谱[]

RecognizedEntitiesModule

定义以前识别的实体的列表。

元素 说明 类型
value 已识别实体的列表。 RecognizedEnityGroup[]

RecognizedEntity

定义识别的实体。

元素 说明 类型
实体 已识别的实体。

以下是可能的实体对象。
对象
matchConfidence 必应图像中的实体与此实体匹配的置信度。 置信度范围为 0.0 到 1.0,1.0 非常自信。 Float

RecognizedEntityGroup

定义一组以前识别的实体。

元素 说明 类型
name 在其中也找到实体图像的组的名称。

以下是可能的组。
  • CelebRecognitionAnnotations - 类似于 CelebrityAnnotations,但提供了更准确的匹配概率。

  • 名人注释 - 包含演员、政治家、运动员和历史人物等名人。
String
recognizedEntityRegions 包含实体的图像的区域。 RecognizedEntityRegion[]

RecognizedEntityRegion

定义在其中找到实体的映像区域以及可能与它匹配的实体列表。

元素 说明 类型
matchingEntities 必应认为与区域中发现的实体匹配的实体列表。 实体按置信度降序 (查看 matchConfidence RecognizedEntity) 字段。 RecognizedEntity[]
region 包含实体的图像的区域。

矩形的值是相对于原始图像的宽和高的,其范围为 0.0 到 1.0。

例如,如果图像为 300x200 且区域的左上角位于 10、20) 和底部 (10、20) ,则右角 (位于 290、150) 点,则规范化矩形为:

Left = 0.03333333333333333333

Top = 0.1

Right = 0.9666666666666667

Bottom = 0.75

就人来说,该区域代表人的面孔。
NormalizedRectangle

RelatedCollectionsModule

定义包含相关图像的网页列表。

元素 说明 类型
value 包含相关图像的网页列表。 ImageGallery[]

RelatedSearchesModule

定义其他人进行的相关搜索列表。

元素 说明 类型
value 其他人进行的相关搜索列表。 Query[]

标记

定义图像中找到的内容的特征。

元素 说明 类型
name 特征的名称。 例如,猫、小猫、卡利科猫。 String

缩略图

定义图像的缩略图。

元素 说明 类型
url 图像缩略图的 URL。 String

Tile

定义图像磁贴。

元素 说明 类型
image 图像缩略图的 URL。 图像
query 返回具有更多主题图像的必应搜索结果页的查询。 例如,如果类别为“热门人脉搜索”,则缩略图为常用人。 该查询将返回一个必应搜索结果页,其中包含该人员的更多图像。 查询

TrendingImages

响应包含的顶级对象,当热门图像请求成功时。

元素 说明 类型
Categories 一个列表,用于标识图像类别以及该类别中趋势图像的列表。 Category[]

错误代码

下面是请求可能返回的 HTTP 状态代码。

状态代码 说明
200 成功。
400 其中一个查询参数丢失或无效。
401 订阅密钥缺失或无效。
403 用户已经过身份验证(例如,用户使用了有效的订阅密钥),但无权访问请求的资源。

如果调用方超出其每月查询配额,必应也可能会返回此状态。
410 请求使用了 HTTP 而非 HTTPS 协议。 HTTPS 是唯一支持的协议。
429 调用方超出其每秒查询配额。
500 意外的服务器错误。

如果请求失败,响应会包含一个 ErrorResponse 对象,该对象包含一系列用于描述错误原因的 Error 对象。 如果错误与参数相关,则 parameter 字段会标识导致问题的参数。 如果错误与参数值相关,则 value 字段会标识无效的参数值。

{
  "_type": "ErrorResponse", 
  "errors": [
    {
      "code": "InvalidRequest", 
      "subCode": "ParameterMissing", 
      "message": "Required parameter is missing.", 
      "parameter": "q" 
    }
  ]
}

{
  "_type": "ErrorResponse", 
  "errors": [
    {
      "code": "InvalidAuthorization", 
      "subCode": "AuthorizationMissing", 
      "message": "Authorization is required.", 
      "moreDetails": "Subscription key is not recognized."
    }
  ]
}

下面是可能的错误代码和子错误代码值。

代码 SubCode 说明
ServerError UnexpectedError
ResourceError
NotImplemented
HTTP 状态代码为 500。
InvalidRequest ParameterMissing
ParameterInvalidValue
HttpNotAllowed
已阻止
只要请求的任何部分无效,必应就会返回 InvalidRequest。 例如,缺少必需参数或参数值无效。

如果错误是 ParameterMissing 或 ParameterInvalidValue,HTTP 状态代码为 400。

如果使用 HTTP 协议而不是 HTTPS 协议,则必应会返回 HttpNotAllowed,且 HTTP 状态代码为 410。
RateLimitExceeded 无子代码 只要超过每秒查询数 (QPS) 或每月查询数 (QPM) 配额,必应就会返回 RateLimitExceeded。

如果超过 QPS,则必应会回 HTTP 状态代码 429;如果超过 QPM,则必应会返回 403。
InvalidAuthorization AuthorizationMissing
AuthorizationRedundancy
当必应无法验证调用方身份时,必应会返回 InvalidAuthorization。 例如,缺少 Ocp-Apim-Subscription-Key 头或订阅密钥无效。

如果指定多个身份验证方法,便会发生冗余。

如果错误是 InvalidAuthorization,HTTP 状态代码为 401。
InsufficientAuthorization AuthorizationDisabled
AuthorizationExpired
当调用方无权访问资源时,必应会返回 InsufficientAuthorization。 如果订阅密钥已遭禁用或到期,就会发生此类错误。

如果错误是 InsufficientAuthorization,HTTP 状态代码为 403。

市场代码

下表列出了可用于指定 mkt 查询参数的市场代码值。 必应仅为这些市场返回内容。 列表可能随时变动。

有关可在查询参数中指定的 cc 国家/地区代码的列表,请参阅 国家/地区代码

国家/地区 语言 市场代码
阿根廷 西班牙语 es-AR
澳大利亚 英语 en-AU
奥地利 德语 de-AT
比利时 荷兰语 nl-BE
比利时 法语 fr-BE
巴西 葡萄牙语 pt-BR
加拿大 英语 en-CA
加拿大 法语 fr-CA
智利 西班牙语 es-CL
丹麦 丹麦语 da-DK
芬兰 芬兰语 fi-FI
法国 法语 fr-FR
德国 德语 de-DE
香港特别行政区 繁体中文 zh-HK
印度 英语 en-IN
印度尼西亚 英语 en-ID
意大利 意大利语 it-IT
日本 日语 ja-JP
韩国 韩语 ko-KR
马来西亚 英语 en-MY
墨西哥 西班牙语 es-MX
荷兰 荷兰语 nl-NL
新西兰 英语 en-NZ
中华人民共和国 中文 zh-CN
波兰 波兰语 pl-PL
葡萄牙 葡萄牙语 pt-PT
菲律宾共和国 英语 en-PH
俄罗斯 俄语 ru-RU
沙特阿拉伯 阿拉伯语 ar-SA
南非 英语 en-ZA
西班牙 西班牙语 es-ES
瑞典 瑞典语 sv-SE
瑞士 法语 fr-CH
瑞士 德语 de-CH
台湾 繁体中文 zh-TW
土耳其 土耳其语 tr-TR
英国 英语 en-GB
美国 英语 zh-CN
美国 西班牙语 es-US

国家/地区代码

下面是可使用 cc 查询参数指定的国家/地区代码。 列表可能随时变动。

国家/地区 国家/地区代码
阿根廷 AR
澳大利亚 AU
奥地利 AT
比利时 BE
巴西 BR
Canada CA
智利 CL
丹麦 DK
芬兰 FI
法国 FR
德国 DE
香港特别行政区 HK
印度 IN
印度尼西亚 ID
意大利 IT
日本 JP
韩国 KR
马来西亚 MY
墨西哥 MX
荷兰 NL
新西兰 NZ
挪威
中华人民共和国 CN
波兰 PL
葡萄牙 PT
菲律宾共和国 PH
俄罗斯 RU
沙特阿拉伯 SA
南非 ZA
西班牙 ES
瑞典 SE
瑞士 CH
中国台湾 TW
土耳其 TR
United Kingdom GB
United States 美国

必应支持的语言

以下是可在查询参数中指定的setLang必应支持的语言。 列表可能随时变动。

支持的语言 语言代码
阿拉伯语 ar
巴斯克语 eu
孟加拉语 bn
保加利亚语 bg
加泰罗尼亚语 ca
中文(简体) zh-hans
中文(繁体) zh-hant
克罗地亚语 hr
捷克语 cs
丹麦语 da
荷兰语 nl
英语 en
English-United王国 en-gb
爱沙尼亚语 et
芬兰语 fi
法语 fr
加利西亚语 gl
德语 de
古吉拉特语 gu
希伯来语 he
Hindi hi
匈牙利语 hu
冰岛语
意大利语 it
日语 Jp
卡纳达语 kn
韩语 ko
拉脱维亚语 lv
立陶宛语 lt
马来语 ms
马拉雅拉姆语 ml
马拉地语 mr
挪威语(博克马尔语) nb
波兰语 pl
葡萄牙语 (巴西) pt-br
葡萄牙 (葡萄牙) pt-pt
旁遮普语 pa
罗马尼亚语 ro
俄语 ru
塞尔维亚 (西里利奇) sr
斯洛伐克语 sk
斯洛文尼亚语 sl
西班牙语 es
瑞典语 sv
泰米尔语 ta
泰卢固语 te
泰语 th
土耳其语 tr
乌克兰语 uk
越南语 vi