Image Search:画像のクエリ

コンソールメソッド

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

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

3. [Image Search] をクリックします。[Image Search] タブで、左側の検索パラメーターを設定し、[Confirm] をクリックして検索します。検索結果は、右側の [Response parameters] セクションに JSON 形式で表示されます。結果には、score (類似度スコア)、productId、picName などのフィールドが含まれます。

   パラメーター	APIパラメーター	説明	必須
   検索タイプ	Type	検索タイプです。有効値は次のとおりです。 SearchByPic：指定された画像に類似する画像を検索します。これがデフォルトのオプションです。 SearchByName：以前にインデックス登録された画像を使用して類似画像を検索します。	はい
   アップロード画像	PicContent	Base64 でエンコードされた画像の内容です。画像は、以下の要件を満たす必要があります。 画像サイズは 4 MB 以下である必要があります。 対応形式：PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、PPM 転送レイテンシーは 5 秒以内である必要があります。 商品画像検索および汎用画像検索の場合、画像の高さと幅はそれぞれ 100 ピクセル以上、4,096 ピクセル以下である必要があります。 画像に回転情報が含まれていてはなりません。	はい
   主体認識	Crop	アップロードされた画像に対して主体認識を実行するかどうかを指定します。 true: システムの自動識別およびカスタムサブジェクト識別を含むサブジェクト識別を有効にします。詳細については、「サブジェクト識別方法 パラメーターの説明」をご参照ください。 false：主体認識を無効にします。検索では画像全体が使用されます。	はい
   主体認識方法	該当なし	主体認識の方法を指定します。 システムの自動認識：システムが自動的に主体を認識し、認識された主体を検索に使用します。レスポンスには主体認識の結果が含まれます。 カスタム主体領域：主体領域をカスタマイズできます。形式は x1,x2,y1,y2 です。x1,y1 は左上隅を、x2,y2 は右下隅を表します。このオプションをクリックし、ドラッグして主体領域を選択します。カスタム主体領域を指定しない場合、検索では画像全体が使用されます。	はい
   画像カテゴリ	CategoryId	画像カテゴリです。画像検索時に画像のカテゴリを指定できます。詳細については、「カテゴリリファレンス」をご参照ください。 説明 商品検索の場合、カテゴリを指定すると、サービスはそのカテゴリを使用します。カテゴリを指定しない場合、システムはカテゴリ予測を実行します。レスポンスには予測されたカテゴリが含まれます。 および汎用検索の場合、カテゴリを指定したかどうかにかかわらず、サービスはカテゴリを 88888888 に設定します。	いいえ
   結果数	Num	返される類似結果の最大数です。値の範囲は 1～100 です。デフォルト値は 10 です。	いいえ
   開始位置	Start	返される類似結果の開始位置です。値の範囲は 0～499 です。	はい
   フィルター条件	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	リクエストが成功したかどうかを示します。
   リクエスト ID	文字列	36C43E96-8F68-44AA-B1AF-B1F7AB94A6C1	リクエスト ID です。
   Code	整数	0	エラーコードです。 0：リクエストは成功しました。 0 以外の値は、リクエストが失敗したことを示します。
   Message	文字列	success	エラーメッセージです。
   Head	-	-	検索結果に関する情報が含まれています。
   └DocsReturn	整数	10	返された結果の数です。
   └DocsFound	整数	10000	インスタンス内で一致した結果の数です。
   └SearchTime	整数	95	検索時間 (単位：ミリ秒) です。
   PicInfo	-	-	カテゴリ予測と主体認識の結果に関する情報です。
   └CategoryId	整数	88888888	カテゴリ予測の結果です。リクエストでカテゴリを指定した場合、このパラメーターはそのカテゴリを返します。
   └Region	文字列	280,486,232,351	主体認識の結果です。これは画像の主体領域で、形式は x1,x2,y1,y2 です。x1 と y1 は左上隅の座標を、x2 と y2 は右下隅の座標を表します。リクエストで主体領域を指定した場合、このパラメーターはその領域を返します。
   └AllCategories	-	-	サポートされているすべてのカテゴリのリストです。
   └└Name	文字列	Tops	カテゴリ名です。
   └└Id	整数	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	整数	0	画像カテゴリです。
   └ProductId	文字列	test	商品 ID です。
   └SortExprValues	文字列	7.33136443711219e+24;0	システムのスコアリング情報です。 説明 このフィールドは非推奨です。代わりに Score の使用を推奨します。
   └Score	浮動小数点数	1.0	画像の類似度スコアです。値の範囲は 0～1 です。 説明 このパラメーターは V3.1.1 以降でのみ利用可能です。
   └IntAttr	整数	0	商品の整数属性です。
   └IntAttr2	整数	0	商品の整数属性です。
   └IntAttr3	整数	0	商品の整数属性です。
   └IntAttr4	整数	0	商品の整数属性です。
   └StrAttr	文字列	demoStrAttr	商品の文字列属性です。
   └StrAttr2	文字列	demoStrAttr	商品の文字列属性です。
   └StrAttr3	文字列	demoStrAttr	商品の文字列属性です。
   └StrAttr4	文字列	demoStrAttr	商品の文字列属性です。

APIメソッド

HTTP または HTTPS プロトコル経由で直接アクセスする場合、署名メカニズムを使用した認証が必要であり、リクエストボディは指定された形式で送信する必要があります。API 経由で類似画像をクエリする場合の QPS は、購入した QPS プランによって決まります。詳細については、「名前による画像の検索」または「画像による画像の検索」 をご参照ください。

SDKメソッド

Image Search はさまざまなバージョンの SDK を提供しており、署名検証やリクエストボディの構築などの複雑な設定を処理する必要がありません。SDK 経由で類似画像をクエリする場合の QPS は、購入した QPS プランによって決まります。詳細については、「SDKリファレンス」をご参照ください。