Bing Image Search API のエンドポイント

警告

2020 年 10 月 30 日に、Bing Search API は Azure AI サービスから Bing Search サービスに移行されました。 このドキュメントは、参考用としてのみ提供されています。 更新されたドキュメントについては、Bing search API のドキュメントを参照してください。 Bing 検索用の新しい Azure リソースを作成する手順については、Azure Marketplace からの Bing Search リソースの作成に関するページを参照してください。

Image Search API には 3 つのエンドポイントが含まれています。 エンドポイント 1 は、クエリに基づいて Web からの画像を返します。 エンドポイント 2 は ImageInsights を返します。 エンドポイント 3 は注目の画像を返します。

エンドポイント

Bing 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 要求では、画像を含む Web ページなど、画像に関する分析情報が返されます。 insightsToken パラメーターを GET 要求に含めます。

または、POST 要求の本文にバイナリ イメージを含めて、modules パラメーターを RecognizedEntities に設定することもできます。 これは、後続の GET 要求でパラメーターとして使用する insightsToken を返します。これは、画像内の人物に関する情報を返します。 modules を All に設定して、insightsToken を使用して別の呼び出しを行わずに、POST の結果内の RecognizedEntities を除くすべての分析情報を取得します。

エンドポイント 3: 他のユーザーが行った検索要求に基づく注目の画像を返します。 画像は、たとえば注目の人物やイベントに基づいて異なるカテゴリに分離されます。

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

注目の画像をサポートする市場の一覧については、注目の画像に関する記事をご覧ください。

ヘッダー、パラメーター、市場コード、応答オブジェクト、エラーなどについて詳しくは、Bing Image Search API v7 のリファレンスをご覧ください。

応答 JSON

画像検索要求に対する応答には、結果が JSON オブジェクトとして含まれます。 結果の解析例については、チュートリアルとソース コードをご覧ください。

次のステップ

Bing API では、種類に応じた結果を返す検索アクションがサポートされます。  すべての検索エンドポイントは、結果を JSON 応答オブジェクトとして返します。  すべてのエンドポイントは、特定の言語や場所を経度、緯度、検索半径によって返すクエリをサポートします。

各エンドポイントでサポートされるパラメーターについて詳しくは、各種類のリファレンス ページをご覧ください。 Image Search API を使用した基本的な要求の例については、Image Search クイック スタートのページをご覧ください。