このトピックでは、Image Search に画像を追加するために使用できる 4 つの方法について説明します。 Image Search コンソールを使用する方法、AddImage オペレーションを呼び出す方法、Image Search SDK を使用する方法、またはバッチ操作機能を使用する方法で画像を追加できます。 画像の追加方法を試す場合は、Image Search コンソールを使用します。 少量の画像をリアルタイムで追加する場合は、Image Search SDK を使用します。 数百万枚の画像を一度に追加する場合は、バッチ操作機能を使用します。 ビジネス要件に基づいて適切な方法を選択できます。
前提条件
Image Search インスタンスが作成されていること。 詳細については、「Image Search の有効化」をご参照ください。
Image Search コンソールの使用
Image Search コンソールにログオンします。
左側のナビゲーションウィンドウで、サービスタイプを選択します。 この例では、[商品検索インスタンス] が選択されています。
サービスタイプの詳細については、「Image Search とは」トピックの「機能」セクションをご参照ください。
管理するインスタンスの ID をクリックします。
[インスタンスの詳細] ページで、[画像の追加] タブをクリックします。
画像の追加パラメータ設定は次のとおりです。パラメータ
AddImage オペレーションのパラメータ名
説明
必須
商品 ID
ProductId
商品の固有 ID。 ID は最大 256 文字まで入力できます。
はい
画像名
PicName
画像の名前。 名前は最大 256 文字まで入力できます。
説明画像は、商品 ID と画像名の組み合わせによって一意に識別されます。
重要商品 ID と画像名が既存の画像と同じ画像を追加すると、新しく追加された画像によって既存の画像が上書きされます。
はい
画像のアップロード
PicContent
アップロードする画像ファイル。 画像ファイルは Base64 でエンコードされています。 アップロードする画像は、次の要件を満たしている必要があります。
画像のファイルサイズは 4 MB を超えることはできません。
画像は、PNG、JPG、JPEG、BMP、GIF、WebP、TIFF、PPM のいずれかの形式である必要があります。
転送タイムアウト期間は 5 秒を超えることはできません。
商品画像検索、一般的な画像検索、家具および家庭用品画像検索、および産業用ハードウェア画像検索の場合、画像の長さと幅は 100 ピクセルから 4,096 ピクセルの範囲である必要があります。
画像に回転設定を含めることはできません。
重要このパラメータでは、Base64 でエンコードされた画像ファイルを直接アップロードする必要があります。 画像 URL を指定して画像をアップロードする方法の詳細については、「SDK for Java」トピックの「追加」セクションをご参照ください。
はい
画像被写体認識
Crop
画像内の被写体を認識し、認識された被写体に基づいて画像を検索するかどうかを指定します。
はい
認識方法
該当なし
画像内の被写体を認識する方法。 有効値：
自動認識：このオプションを選択すると、システムは被写体を認識し、認識された被写体に基づいて画像を検索します。 認識結果はレスポンスで取得できます。
主要被写体エリアの定義：被写体認識のエリアを指定できます。 被写体エリアを指定しない場合、システムは画像全体に基づいて画像を検索します。
はい
画像カテゴリ
CategoryId
画像のカテゴリ。 画像を追加するときに、画像のカテゴリを指定できます。
説明商品画像検索には、組み込みの自動カテゴリ予測機能が用意されています。 画像のカテゴリを指定しない場合、システムは画像のカテゴリを自動的に予測し、予測されたカテゴリをエンジンにインデックス化します。 予測結果はレスポンスで返されます。
商品画像検索中に、システムはアップロードした画像のカテゴリも自動的に予測し、予測されたカテゴリに基づいて画像を検索して検索範囲を絞り込み、検索精度を向上させます。
商品画像検索では、デフォルトの自動カテゴリ予測機能を使用することをお勧めします。
布地画像検索、ブランド画像検索、一般的な画像検索、著作権で保護された画像検索、産業用ハードウェア画像検索、および家具と家庭用品の画像検索の場合、カテゴリが指定されているかどうかに関係なく、レスポンスでカテゴリ ID として 88888888 が返されます。
カテゴリの詳細については、「カテゴリのリファレンス」をご参照ください。
重要画像をアップロードするときに画像のカテゴリを指定する場合は、画像を検索するときに画像検索に同じカテゴリを指定する必要があります。 そうしないと、アップロードした画像のソース画像を検索できません。
いいえ
カスタムコンテンツ
CustomContent
ユーザー定義コンテンツ。 値は最大 4,096 文字まで入力できます。
説明画像のユーザー定義コンテンツは、検索結果に自動的に返されます。 このパラメータを使用して、画像 URL や画像の説明などの情報を追加できます。
いいえ
整数属性
IntAttr
画像の整数型属性。 この属性は、画像を検索するときに画像をフィルタリングするために使用できます。
説明画像を検索するときに、整数属性パラメータとフィルタ条件を指定して画像をフィルタリングできます。 詳細については、「フィルタ条件を指定して画像を検索する」をご参照ください。
いいえ
整数属性 2
IntAttr2
画像の整数型属性。 この属性は、画像を検索するときに画像をフィルタリングするために使用できます。
説明画像を検索するときに、整数属性 2 パラメータとフィルタ条件を指定して画像をフィルタリングできます。 詳細については、「フィルタ条件を指定して画像を検索する」をご参照ください。
このパラメータは、2023 年 1 月 3 日以降に作成されたインスタンスにのみ表示されます。
いいえ
文字列属性
StrAttr
画像の文字列型属性。 値は最大 128 文字まで入力できます。 この属性は、画像を検索するときに画像をフィルタリングするために使用できます。
説明画像を検索するときに、文字列属性パラメータとフィルタ条件を指定して画像をフィルタリングできます。 詳細については、「フィルタ条件を指定して画像を検索する」をご参照ください。
いいえ
文字列属性 2
StrAttr2
画像の文字列型属性。 値は最大 128 文字まで入力できます。 この属性は、画像を検索するときに画像をフィルタリングするために使用できます。
説明画像を検索するときに、文字列属性 2 パラメータとフィルタ条件を指定して画像をフィルタリングできます。 詳細については、「フィルタ条件を指定して画像を検索する」をご参照ください。
このパラメータは、2023 年 1 月 3 日以降に作成されたインスタンスにのみ表示されます。
いいえ
[OK] をクリックします。
AddImage オペレーションの呼び出し
HTTP または HTTPS 経由でリクエストを送信して Image Search の AddImage オペレーションを呼び出すことで、画像を追加できます。 この方法では、署名を使用してリクエスト者を認証し、リクエスト本文を指定された形式で送信する必要があります。 AddImage オペレーションの呼び出しに対するデフォルトの 1 秒あたりのクエリ数（QPS）制限は 5 QPS です。 詳細については、「AddImage」をご参照ください。
Image Search SDK の使用
Image Search は、複数バージョンの SDK を提供しています。 Image Search SDK を使用して画像を追加する場合、署名検証やリクエスト本文の形式への準拠などの問題を気にする必要はありません。 少量の画像をリアルタイムで追加する場合は、Image Search SDK を使用することをお勧めします。 Image Search SDK を使用して画像を追加する場合、QPS 制限は、画像容量仕様が 0.1 百万枚のインスタンスの場合は 1 QPS、その他の画像容量仕様のインスタンスの場合は 5 QPS です。 詳細については、「SDK for Java」トピックの「追加」セクションをご参照ください。
バッチ操作機能の使用
Image Search を Object Storage Service（OSS）に接続した後、OSS から Image Search に複数の画像を一度にインポートできます。 この方法は、数百万枚の画像を一度に追加するシナリオに適しています。 詳細については、「バッチ操作の実行」をご参照ください。