共用方式為


Bing 影像搜尋 API 的端點

警告

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

影像搜尋 API 包含三個端點。 端點 1 會根據查詢從 Web 傳回影像。 端點 2 會傳回 ImageInsights。 端點 3 會傳回趨勢影像。

端點

若要使用 Bing API 取得影像結果,請將要求傳送至下列其中一個端點。 使用標頭和 URL 參數來定義進一步的規格。

端點 1: 傳回與 ?q=""所定義之使用者搜尋查詢相關的影像。

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

端點 2: 使用 GETPOST傳回影像的相關深入解析。

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

HTTP GET 要求會傳回影像的相關資訊,例如包含該影像的網頁。 將 insightsToken 參數與 GET 要求包含在內。

或者,您可以在 POST 要求的主體中包含二進位映像,並將 模組 參數設定為 RecognizedEntities。 這會返回 insightsToken,作為後續 GET 請求中的參數,這會返回影像中人員的相關資訊。 將 modules 設定為 All,以獲取所有見解,除了在 RecognizedEntities 結果中的 POST,並且無需使用 insightsToken進行其他呼叫。

API 端點 3: 返回以其他人提出的搜尋要求為基礎的熱門圖像。 影像會根據值得注意的人員或事件,分成不同的類別。

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

如需支持趨勢影像的市場清單,請參閱 趨勢影像

如需標頭、參數、市場代碼、回應物件、錯誤等的詳細資訊,請參閱 Bing 影像搜尋 API v7 參考。

回應 JSON

影像搜尋要求的回應會以 JSON 物件的形式包含結果。 如需剖析結果的範例,請參閱 教學課程原始程式碼

後續步驟

Bing API 支援根據其類型傳回結果的搜尋動作。 所有搜尋端點都會以 JSON 回應物件的形式傳回結果。  所有端點都支援依經度、緯度和搜尋半徑傳回特定語言和/或位置的查詢。

如需每個端點所支援之參數的完整資訊,請參閱每個類型的參考頁面。 如需使用影像搜尋 API 的基本要求範例,請參閱 影像搜尋快速入門