共用方式為

使用 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 查詢參數。 例如，如果您輸入 sailing dinghies，請將 q 設定為 sailing+dinghies 或 sailing%20dinghies。

重要

  • 所有要求都必須是從伺服器進行，不能從用戶端進行。
  • 如果這是您第一次呼叫任何 Bing 搜尋 API，請勿包含用戶端識別碼標頭。 如果您先前已呼叫 Bing 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

注意

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

篩選影像

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

  • aspect：依照外觀比例篩選影像 (例如，標準或寬螢幕影像)。
  • color：依照主色或黑白篩選影像。
  • freshness：依照存在時間篩選影像 (例如，Bing 在過去一週中探索的影像)。
  • height、width：依照寬度和高度篩選影像。
  • imageContent：依照內容篩選影像 (例如只顯示人臉的影像)。
  • imageType：依照類型篩選影像 (例如，美工圖案、動畫 GIF 或透明背景)。
  • license：依照與網站相關聯的授權類型篩選影像。
  • size：依照大小篩選影像，例如最大 200 x 200 像素的小型影像。

若要從特定網域取得影像，請使用 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 服務判斷與查詢相關的影像清單。 清單中的每個影像物件包含下列影像相關資訊：URL、影像大小、影像維度、影像編碼格式、影像縮圖的 URL 及縮圖的維度。

注意

  • 影像必須以回應中提供的順序來顯示。
  • 因為 URL 格式和參數可隨時變更而不會另行通知，因此請依原狀使用所有 URL。 除非有註明，否則請勿相依於 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 應用程式的教學課程。