すべてのプロダクト
Search
ドキュメントセンター

Image Search:Image Search の使用に関するよくある質問

最終更新日:Apr 01, 2026

検索動作

商品画像検索と一般的な画像検索の違いは何ですか?

商品画像検索は画像の分類をサポートしており、画像から抽出されたコンテキスト情報を活用して、特定のカテゴリに完全に属する結果を検索します。このため、カテゴリ精度が重要なオンラインショッピングなどのシナリオに適しています。

一般的な画像検索は画像の分類をサポートしません。カテゴリ ID の指定は不要であり、カテゴリによるフィルタリングも適用されません。ストックフォトや写真共有サイト、フォーラムなどで利用されます。

画像の検索または登録時にカテゴリ ID を指定する必要がありますか?

検索タイプによって異なります:

  • 商品画像検索一般的な画像検索:カテゴリ ID は任意です。指定した場合、その値が優先されます。未指定の場合は、システムがカテゴリを予測し、応答に予測されたカテゴリ ID を返します。

  • 布地、ブランド、および一般的な画像検索:指定の有無に関わらず、システムは常にカテゴリ ID を 88888888 に設定します。

Crop パラメーターと Region パラメーターの動作は?

システムの動作は、Crop、Region、および検索タイプの組み合わせによって決まります:

CropRegion検索タイプシステム動作
true または未設定指定あり任意指定された領域を主題領域として使用
true または未設定未指定任意主題領域を自動的に検出
false任意任意主題検出をスキップし、画像全体から特徴を抽出
任意任意布地画像検索Crop および Region の両方を無視し、画像全体に基づいて検索

検索結果内の SortExprValues の解釈方法は?

SortExprValues は、セミコロン (;) で区切られた 2 つの値を返します:

  • 1 つ目の値 — 関連性スコア。数値が大きいほど、返された画像は検索画像とより類似しています。有効範囲は [0, 7.33136443711219e+24] であり、7.33136443711219e+24 は完全に一致することを示します。

  • 2 つ目の値 — 2 つの画像の固有ベクトル間のハミング距離。数値が大きいほど、画像の類似度は低くなります。

結果は 1 つ目の値でソートされます。Image Search では、2 つの画像が一致するかどうかを判断するための類似度しきい値は提供されていません。

SDK および API

buildPostContent の呼び出しに失敗する理由は?

以下の点をご確認ください:

  • すべての必須フィールドに値が設定されていること。

  • リクエストボディが 8 MB 未満であること。

OSS 統合

Image Search インスタンスとは異なるリージョンにある OSS バケットを使用できますか?

いいえ。Image Search インスタンスは、異なるリージョンにある OSS バケットからデータを読み取ることはできません。Image Search インスタンスと OSS バケットは、同じリージョンに配置する必要があります。

OSS インポート要求が失敗する原因は?

最も一般的な原因は、リージョンの不一致と RAM ユーザーの権限不足です。

リージョンの不一致

OSS バケットと Image Search インスタンスが異なるリージョンに配置されています。Image Search が利用可能なリージョンは以下のとおりです:

  • 中国 (上海)

  • シンガポール

  • 中国 (香港)

  • 日本 (東京)

  • ドイツ (フランクフルト)

  • オーストラリア (シドニー) (サービス終了予定)

RAM ユーザーの権限不足

RAM ユーザーが Image Search または Object Storage Service (OSS) へのアクセスに必要な権限を持っていません。以下の点をご確認ください:

  • RAM ユーザーに Image Search および OSS アクセス用の必要なポリシーがアタッチされていること。

  • ARN、バケット名、およびデータパスが有効であること。

  • 指定されたデータパスに increment.meta ファイルが存在すること。