共用方式為

使用 Bing 影像搜尋 API 從 Web 取得影像

警告

在 2020 年 10 月 30 日，Bing 搜尋 API 從 Azure AI 服務移至 Bing 搜尋服務。 本檔僅供參考。 如需更新的檔案，請參閱 Bing 搜尋 API 檔案。 如需建立 Bing 搜尋新 Azure 資源的指示，請參閱透過 Azure Marketplace 建立 Bing 搜尋資源。

當您使用 Bing 影像搜尋 REST API 時，您可以傳送下列 GET 要求，從與搜尋字詞相關的 Web 取得影像：

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
X-MSEdge-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com

針對 url 編碼的搜尋字詞，使用 q 查詢參數。 例如，如果您輸入 小帆船，請將 q 設定為 sailing+dinghies 或 sailing%20dinghies。

這很重要

  • 所有要求都必須從伺服器提出，而不是從用戶端提出。
  • 如果您是第一次呼叫任何 Bing 搜尋 API，請勿包含用戶端識別碼標頭。 如果您曾經呼叫過 Bing API，且該 API 為使用者和裝置組合傳回了一個用戶端識別碼，則只需包含該用戶端識別碼。

從特定 Web 網域取得影像

若要從特定網域取得影像，請使用 site: 查詢運算符。

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies+site:contososailing.com&mkt=en-us HTTP/1.1

備註

不論 site: 設定為何，使用 運算子的查詢回應可能包含成人內容。 只有在您知道網域上的內容時，才使用 site:。

篩選影像

根據預設，影像搜尋 API 會傳回與查詢相關的所有影像。 如果您想要篩選 Bing 傳回的影像（例如，只傳回具有透明背景或特定大小的影像），請使用下列查詢參數：

  • 長寬比—依長寬比篩選圖片（例如標準或寬螢幕）。
  • 色彩— 依主要色彩或黑白篩選影像。
  • 新鮮度—依年齡篩選影像（例如 Bing 在過去一周發現的影像）。
  • 高度、寬度—依寬度和高度篩選影像。
  • imageContent— 依內容篩選影像（例如，只顯示人員臉部的影像）。
  • imageType—依類型篩選影像（例如美工圖案、動畫 GIF 或透明背景）。
  • 授權— 依與網站相關聯的授權類型篩選映射。
  • 大小— 依大小篩選影像，例如最多 200x200 像素的小影像。

若要從特定網域取得影像，請使用 site: 查詢運算符。

下列範例示範如何取得 Bing 在過去一周發現的 ContosoSailing.com 上的小圖像。

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies+site:contososailing.com&size=small&freshness=week&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
X-MSEdge-ClientIP: 999.999.999.999  
X-Search-Location: lat:47.60357;long:-122.3295;re:100  
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>  
Host: api.cognitive.microsoft.com

Bing 影像搜尋回應格式

來自 Bing 的回應訊息包含 影像 答案，其中包含 Azure AI 服務判斷與查詢相關的影像清單。 清單中的每個 Image 物件都包含下列影像相關信息：URL、其大小、維度、編碼格式、影像縮圖的 URL，以及縮圖的維度。

備註

  • 影像必須以回應中提供的順序顯示。
  • 由於 URL 格式和參數可能會變更而不通知，因此請使用所有 URL as-is。 除非有特別說明，否則您不應依賴於 URL 的格式或參數。
{
    "name": "Rich Passage Sailing Dinghy",
    "webSearchUrl": "https:\/\/www.bing.com\/cr?IG=73118C8B4E3...",
    "thumbnailUrl": "https:\/\/tse1.mm.bing.net\/th?id=OIP.GNarK7m...",
    "datePublished": "2011-10-29T11:26:00",
    "contentUrl": "http:\/\/www.bing.com\/cr?IG=73118C8B4E3D4C3...",
    "hostPageUrl": "http:\/\/www.bing.com\/cr?IG=73118C8B4E3D4C3687...",
    "contentSize": "79239 B",
    "encodingFormat": "jpeg",
    "hostPageDisplayUrl": "en.contoso.org\/wiki\/File:Rich_Passage...",
    "width": 526,
    "height": 688,
    "thumbnail": {
        "width": 229,
        "height": 300
    },
    "imageInsightsToken": "ccid_GNarK7ma*mid_CCF85447ADA6...",
    "insightsSourcesSummary": {
        "shoppingSourcesCount": 0,
        "recipeSourcesCount": 0
    },
    "imageId": "CCF85447ADA6FFF9E96E7DF0B796F7A86E34593",
    "accentColor": "376094"
},

當您呼叫 Bing 影像搜尋 API 時，Bing 會傳回結果清單。 此清單是與查詢相關的結果總數子集。 回應的 [totalEstimatedMatches] 字段包含可供檢視之影像數目的估計值。 如需如何逐頁瀏覽其餘影像的詳細資訊，請參閱 分頁影像。

後續步驟

如果您之前尚未嘗試 Bing 影像搜尋 API，請嘗試 快速入門。 如果您要尋找更複雜的專案，請嘗試本教學課程來建立 單頁 Web 應用程式。

  • Last updated on