Image Search:画像のクエリ

コンソールでの操作

1. Image Search コンソールにログインします。

2. 対象のサービスタイプとインスタンスを選択します。

3. [Image Search] をクリックします。

   パラメーター	対応する API パラメーター	説明	必須
   検索タイプ	Type	利用可能な検索タイプは 2 つあります： SearchByPic：指定した画像に基づいて類似画像を検索します。これはデフォルト値です。 SearchByName：以前に追加した画像に基づいて類似画像を検索します。	はい
   画像のアップロード	PicContent	画像コンテンツ。Base64 エンコードされている必要があります。画像は次の要件を満たす必要があります： 画像サイズは 4 MB を超えることはできません。 画像は PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、または PPM 形式である必要があります。 転送遅延は 5 秒未満です。 商品画像検索および一般的な画像検索の場合、画像の高さと幅は 100 ピクセルから 4096 ピクセルの範囲内 (両端を含む) である必要があります。 画像に回転情報を含めることはできません。	はい
   主題の識別	Crop	検索中にアップロードされた画像内の主題を検出するかどうかを指定します。 true に設定した場合：システムは主題の識別を実行します。これには、システムの自動識別とカスタムの主題識別が含まれます。詳細については、主題の識別方法 パラメーターをご参照ください。 false：主題を検出しません。画像全体が検索に使用されます。	はい
   主題の識別方法	N/A	主題を識別する方法： システムの自動識別：システムが自動的に主題を検出し、検索に使用します。主題の識別の結果は応答で利用可能です。 カスタムの主題領域：主題の識別のためのカスタム領域を指定できます。フォーマットは x1,x2,y1,y2 です。ここで、x1,y1 は左上の点の座標、x2,y2 は右下の点の座標です。このオプションを選択した場合、ボックスをドラッグして画像内の主題領域を選択できます。カスタム領域を指定しない場合、画像全体が検索に使用されます。	はい
   画像カテゴリ	CategoryId	画像カテゴリ。CategoryId です。検索中に画像のカテゴリを指定できます。詳細については、「カテゴリリファレンス」をご参照ください。 説明 商品検索の場合、カテゴリを設定すると指定したカテゴリが使用されます。カテゴリを設定しない場合、システムがカテゴリを予測します。予測されたカテゴリは応答で利用可能です。 一般的な検索の場合、カテゴリを指定したかどうかに関わらず、システムはカテゴリを 88888888 に設定します。	いいえ
   結果数	Num	返される類似結果の最大数。値は 1 から 100 の範囲内である必要があります。デフォルト値は 10 です。	いいえ
   結果の開始位置	Start	返される類似結果の開始位置。値は 0 から 499 の範囲内である必要があります。デフォルト値は 0 です。	はい
   フィルター条件	Filter	フィルター条件を設定して、条件を満たす画像結果のみを返すことができます。たとえば、ownerId が 1000 の画像結果のみ、または会社名が「alibaba」の画像結果のみを返すことができます。 説明 `int_attr` フィールドは、オペレーター >、>=、<、<=、=、in、および not in をサポートします。 `str_attr` フィールドは、オペレーター =、!=、in、および not in をサポートします。 AND と OR を使用して、複数の条件を接続できます。 例：`int_attr=1000 AND str_attr="value1"`。	いいえ
   類似度スコアフィルター	ScoreThreshold	類似度のしきい値を指定すると、システムはしきい値以上の類似度スコアを持つ画像の情報のみを返します。しきい値は 0.00 から 1.00 の範囲内である必要があり、小数点以下 2 桁までサポートされます。デフォルト値は 0.00 です。	いいえ

4. 返された結果を表示します。

   次の表に、応答のパラメーターを説明します。

   パラメーター	タイプ	例	説明
   Success	ブール値	true	リクエストが成功したかどうかを示します。
   RequestId	文字列	36C43E96-8F68-44AA-B1AF-B1F7AB94A6C1	リクエスト ID。
   Code	Integer	0	エラーコード： 0 は成功を示します。 0 以外の値は失敗を示します。
   Message	文字列	success	エラーメッセージ。
   Head	-	-	検索結果に関する情報。
   └DocsReturn	Integer	10	返された結果の数。
   └DocsFound	Integer	10000	インスタンスでヒットした結果の数。
   └SearchTime	Integer	95	検索にかかった時間 (ミリ秒)。
   PicInfo	-	-	カテゴリ予測や主題の識別の結果などの情報。
   └CategoryId	Integer	88888888	カテゴリ予測の結果。リクエストでカテゴリが指定されていた場合、指定されたカテゴリが返されます。
   └Region	文字列	280,486,232,351	主題の識別の結果。これは画像の主題領域で、x1,x2,y1,y2 の形式です。x1 と y1 は左上の点の座標、x2 と y2 は右下の点の座標です。リクエストで主題領域が指定されていた場合、指定された領域が返されます。
   └AllCategories	-	-	システムでサポートされているすべてのカテゴリに関する情報。
   └└Name	文字列	Tops	カテゴリ名。
   └└Id	Integer	0	カテゴリ ID。
   └MultiRegion	-	-	主題の識別の結果のセット。 説明 この機能を使用するには、バージョン V3.1.1 にアップグレードする必要があります。
   └└Region	文字列	280,486,232,351	主題の識別の結果。これは画像の主題領域で、x1,x2,y1,y2 の形式です。x1 と y1 は左上の点の座標、x2 と y2 は右下の点の座標です。リクエストで主題領域が指定されていた場合、指定された領域が返されます。
   Auctions	-	-	返されたすべてのプロダクトの記述情報。
   └CustomContent	文字列	Demo Custom Content	カスタムコンテンツ。
   └PicName	文字列	DemoPic	画像名。
   └CategoryId	Integer	0	画像カテゴリ。
   └ProductId	文字列	test	プロダクト ID。
   └SortExprValues	文字列	7.33136443711219e+24;0	システムのスコアリング情報。 説明 このフィールドは非推奨です。代わりに Score を使用してください。
   └Score	Float	1	画像の類似度スコア。値は 0 から 1 の範囲です。 説明 この機能を使用するには、バージョン V3.1.1 にアップグレードする必要があります。
   └IntAttr	Integer	0	整数の属性。
   └IntAttr2	Integer	0	整数の属性。
   └IntAttr3	Integer	0	整数の属性。
   └IntAttr4	Integer	0	整数の属性。
   └StrAttr	文字列	demoStrAttr	文字列の属性。
   └StrAttr2	文字列	demoStrAttr	文字列の属性。
   └StrAttr3	文字列	demoStrAttr	文字列の属性。
   └StrAttr4	文字列	demoStrAttr	文字列の属性。

API 方式

HTTP または HTTPS を介してサービスに直接アクセスできます。リクエストを認証するために署名メカニズムを使用し、リクエストボディを要件に応じてフォーマットする必要があります。1 秒あたりの最大クエリ数 (QPS) は、購入したリソースプランによって決まります。詳細については、「名前による画像の検索」または「画像による画像の検索」 をご参照ください。

SDK 方式 (推奨)

Image Search は、複数のプログラミング言語用の SDK を提供しています。署名認証やリクエストボディの組み立てなど、複雑な構成を管理する必要はありません。1 秒あたりの最大クエリ数 (QPS) は、購入したリソースプランによって決まります。詳細については、「SDK リファレンス」をご参照ください。