how to add images in image search - Image Search - Alibaba Cloud ドキュメントセンター

Image Search は、インスタンスに画像を追加するための 4 つのメソッドをサポートしています。お客様の規模や統合要件に応じて選択してください：

メソッド	最適な用途
Image Search コンソール	テストおよび 1 回限りのアップロード
AddImage API	詳細な制御を必要とするカスタム統合
Image Search SDK	小規模な画像セットのリアルタイムアップロード
バッチ操作	数百万枚の画像を一度にインポート

重要

各画像は、ProductId と PicName の組み合わせによって一意に識別されます。既存の画像と同じ ProductId と PicName を持つ画像を追加すると、既存の画像が上書きされます。

前提条件

開始する前に、以下を確認してください：

Image Search インスタンスが作成済みであること。詳細については、「Image Search の有効化」をご参照ください。

Image Search コンソールの使用

コンソールを使用して、画像追加のワークフローを確認したり、1 回限りのアップロードを実行したりします。

Image Search コンソールにログインします。Image Search コンソール
左側のナビゲーションウィンドウで、サービスタイプを選択します。この例では、[商品検索インスタンス] を使用します。サービスタイプの詳細については、「Image Search とは」の「特徴」セクションをご参照ください。
管理対象のインスタンスの ID をクリックします。
「[インスタンスの詳細]」ページで、「[イメージの追加]」タブをクリックします。
以下に説明するパラメーターを設定した後、[OK] をクリックします。

必須パラメーター

パラメーター	API パラメーター	説明
商品 ID	`ProductId`	一意のプロダクト ID。最大 256 文字です。
イメージ名	`PicName`	イメージ名。最大 256 文字です。
イメージのアップロード	`PicContent`	Base64 でエンコードされたイメージファイル。下記のイメージファイルの要件をご参照ください。
イメージの主題認識	`Crop`	イメージ内の主題を検出し、それを検索の基準として使用するかどうかを指定します。
認識メソッド	N/A	主題検出メソッド： [自動認識] または [主題領域を定義]。 [主題領域を定義] を選択し、エリアを指定しない場合、システムはイメージ全体を使用します。

画像ファイルの要件 (`PicContent`)：

最大ファイルサイズ：4 MB
対応フォーマット：PNG、JPG、JPEG、BMP、GIF、WebP、TIFF、PPM
送信タイムアウト：5 秒
寸法：縦横 100～4,096 ピクセル (商品、汎用、家具・家庭用品、工業用ハードウェアの画像検索に適用)
ファイルに回転設定が埋め込まれていないこと

重要

PicContent では、Base64 でエンコードされた画像ファイルを直接アップロードする必要があります。画像 URL を指定してアップロードするには、「Java 版 SDK」の「追加」セクションをご参照ください。

任意パラメーター

パラメーター	API パラメーター	説明
画像カテゴリ	`CategoryId`	画像に割り当てるカテゴリ。商品画像検索の場合、このパラメーターを省略すると、システムは自動的にカテゴリを予測し、予測されたカテゴリにインデックスを作成し、応答で予測結果を返します。商品画像検索では、このデフォルトの自動カテゴリ予測を使用することを推奨します。商品画像検索中、システムは検索画像のカテゴリも自動予測し、範囲を絞り込んで精度を向上させます。布地、ブランド、汎用、著作権、工業用ハードウェア、家具・家庭用品の画像検索の場合、カテゴリが指定されているかどうかに関わらず、応答は常に `88888888` を返します。
カスタムコンテンツ	`CustomContent`	検索結果で自動的に返されるユーザー定義のメタデータ (例：画像 URL や説明)。最大 4,096 文字。
整数属性	`IntAttr`	検索結果のフィルタリングに使用する整数型の属性。
整数属性2	`IntAttr2`	検索結果のフィルタリングに使用する追加の整数型の属性。
整数属性3	`IntAttr3`	検索結果のフィルタリングに使用する追加の整数型の属性。
整数属性4	`IntAttr4`	検索結果のフィルタリングに使用する追加の整数型の属性。
文字列属性	`StrAttr`	検索結果のフィルタリングに使用する文字列型の属性。最大 128 文字。特殊文字 `\ ¥ $&%` はサポートされていません。
文字列属性2	`StrAttr2`	検索結果のフィルタリングに使用する追加の文字列型の属性。
文字列属性3	`StrAttr3`	検索結果のフィルタリングに使用する追加の文字列型の属性。
文字列属性4	`StrAttr4`	検索結果のフィルタリングに使用する追加の文字列型の属性。

整数属性および文字列属性によるフィルタリングの詳細については、「フィルター条件を指定した画像検索」をご参照ください。

重要

画像を追加する際に CategoryId を指定した場合、その画像を検索する際にも同じカテゴリを指定する必要があります。そうしないと、画像は検索結果に表示されません。利用可能なカテゴリについては、「カテゴリリファレンス」をご参照ください。

AddImage API の呼び出し

AddImage 操作に HTTP または HTTPS リクエストを送信して、プログラムで画像を追加します。リクエストには署名ベースの認証が必要であり、指定されたリクエストボディのフォーマットに従う必要があります。

デフォルトの QPS 制限：5 QPS

完全な API リファレンスについては、「AddImage」をご参照ください。

Image Search SDK の使用

Image Search SDK は、署名検証とリクエストフォーマットを自動的に処理するため、リアルタイムの画像アップロードをご利用のアプリケーションに統合する最も速い方法です。

インスタンス容量別の QPS 制限：

画像容量が 10 万のインスタンス仕様の場合：1 QPS
その他のすべての画像容量仕様の場合：5 QPS

SDK の使用方法とコード例については、「Java 版 SDK」の「追加」セクションをご参照ください。

バッチ操作機能の使用

Image Search を Object Storage Service (OSS) に接続して、OSS から画像をまとめてインポートします。このメソッドは、数百万枚の画像を一度に大規模にインポートするために設計されています。

設定と詳細な手順については、「バッチ操作の実行」をご参照ください。

Image Search:画像の追加