Bing Visual Search API とは
警告
2020 年 10 月 30 日に、Bing Search API は Azure AI サービスから Bing Search サービスに移行されました。 このドキュメントは、参考用としてのみ提供されています。 更新されたドキュメントについては、Bing search API のドキュメントを参照してください。 Bing 検索用の新しい Azure リソースを作成する手順については、「Azure Marketplace から Bing Search リソースを作成する」を参照してください。
Bing Visual Search API は、画像に関する分析情報を返します。 画像をアップロードするか、画像の URL を指定することができます。 分析情報とは、視覚的に似ている画像、ショッピング ソース、その画像が含まれる Web ページなどです。 Bing Visual Search API によって返される分析情報は、Bing.com/images に表示される情報と似ています。
Bing Image Search API を使用する場合は、画像をアップロードする代わりに、その API の検索結果の分析情報トークンを Bing Visual Search に使用できます。
重要
Bing Image Search API を使用して画像に関する分析情報を取得する場合は、より包括的な分析情報が取得できる Bing Visual Search API への切り替えを検討してください。
洞察
Bing Visual Search を使用すると、次の分析情報を検出できます。
| 分析情報 | 説明 |
|---|---|
| 見た目が似ている画像 | 入力画像に視覚的に似ている画像の一覧。 |
| ショッピング ソース | 入力画像に示されているアイテムを購入できる場所の一覧。 |
| 関連検索 | 他のユーザーによって行われた関連検索または画像の内容に基づく関連検索。 |
| 画像を含む Web ページ | 入力画像を含む Web ページ。 |
| レシピ | 入力画像に示されている料理を作るためのレシピを含む Web ページ。 |
| エンティティ | 有名な人物、場所、もの |
分析情報だけでなく、Bing Visual Search は、入力画像から派生したさまざまな用語 (つまり、タグ) も返します。 これらのタグを使用して、ユーザーは画像で見つかる概念を調べることができます。 たとえば、入力画像が有名なアスリートである場合、そのアスリートの名前や "スポーツ" がタグとして返される可能性があります。 また、入力画像がアップル パイの場合は、"アップル パイ"、"パイ"、"デザート" などのタグが使用されるでしょう。
Bing Visual Search の結果には、画像内で興味を引く部分を囲む境界ボックスも含まれます。 たとえば、画像に複数の有名人が含まれている場合、結果には認識された各有名人の境界ボックスが含まれる可能性があります。 また、Bing が画像内で製品や衣類を認識した場合、認識されたアイテムに対する境界ボックスが結果に含まれることがあります。
ワークフロー
Bing Visual Search API は RESTfulWeb サービスです。HTTP 要求を作成して JSON を解析できる任意のプログラミング言語から簡単に呼び出すことができます。 このサービスに対しては、REST API または SDK を使用できます。
- Bing Search API シリーズにアクセスするための Azure AI サービス アカウントを作成します。 Azure サブスクリプションをお持ちでない場合は、無料でアカウントを作成できます。
- 有効な検索クエリを使用して API に要求を送信します。
- 返された JSON メッセージを解析して API 応答を処理します。
次のステップ
まず、Bing Visual Search API の対話型のデモを試してみてください。 このデモは、検索クエリをすばやくカスタマイズし、Web で画像を検索する方法を示しています。
実際に要求を送信してみるには、クイック スタートを参照してください:
関連項目
「Images - Visual Search」リファレンスには、画像ベースの検索結果を要求するために使用できるエンドポイント、要求ヘッダー、応答、およびクエリ パラメーターに関する定義と情報が含まれています。
「Bing Search API の利用と表示の要件」では、Bing Search API シリーズを使用して得られるコンテンツと情報の許可される使用方法が指定されています。
その他の提供されている API については、Bing Search API ハブ ページをご覧ください。