このトピックでは、画像の追加に使用できる 4 つの方法について説明します。 API の呼び出し、SDK の使用、バッチ操作の実行、およびコンソールの使用により、画像を追加できます。
少数の画像をリアルタイムで追加する必要がある場合は、SDK を使用します。 タスクを使用して数百万の画像を追加する必要がある場合は、バッチ操作を実行します。 画像検索で画像ギャラリーに画像を追加する方法を体験したい場合は、コンソールを使用してください。
ビジネスニーズに応じて適切な方法を選択してください。
コンソールの使用
- Image Search コンソールにログインします。
- 左側のナビゲーションペインで、必要なサービスを選択します。
サービスタイプの詳細については、「
特徴」をご参照ください。
- 必要なインスタンス ID をクリックします。
- [画像の追加] タブをクリックします。
以下のパラメーターの説明に基づいて、画像を追加するパラメーターを指定します。
パラメーター |
API のパラメーター名 |
説明 |
必須事項 |
商品 ID |
ProductId |
プロダクトを特定する一意の ID を設定します。 ID の長さは、最大 256 文字です。 |
必須 |
画像名 |
PicName |
画像の名前を設定します。 名前の長さは、最大 256 文字です。
注
- 画像は、商品 ID と画像名の組み合わせによって一意に識別されます。
- 商品 ID と画像名が同じ複数の画像がある場合は、最新の画像が優先されます。
|
必須 |
アップロードする画像 |
PicContent |
アップロードする画像を指定します。 画像ファイルは Base64 でエンコードされます。 アップロードする画像は、以下の要件を満たす必要があります。
- ファイルサイズは 4 MB 以下とする必要があります。
- Image Search は、PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、および PPM の画像形式をサポートしています。
- 送信時のタイムアウト期間は 5 秒です。
- 商品および一般的な画像検索の場合、画像の高さと幅は 100 ピクセルから 4096 ピクセルの範囲とする必要があります。
- 画像に回転情報を含めることはできません。
|
必須 |
被写体検出 |
Crop |
画像内の被写体を検出し、検出した被写体に基づいて画像を検索するかどうかを指定します。 |
必須 |
検出方法 |
- |
画像内の被写体を検出する方法を指定します。 設定可能な値は以下のとおりです。
- 自動認識:このオプションを選択すると、システムが被写体を検出し、検出された被写体に基づいて画像を検索します。 レスポンスで検出結果を取得できます。
- 被写体エリアを指定:サブジェクト認識用のエリアを指定できます。 被写体エリアを指定しない場合、システムは画像全体に基づいて画像を検索します。
|
必須 |
画像カテゴリ |
CategoryId |
画像のカテゴリを指定します。 画像を追加する際、画像のカテゴリを指定できます。 |
任意 |
カスタムコンテンツ |
CustomContent |
ユーザー定義のコンテンツを設定します。 値の長さは、最大 4096 文字です。 |
任意 |
整数属性 |
IntAttr |
整数属性を設定します。 この属性を使用して、画像検索時に画像をフィルタリングできます。 |
任意 |
文字列属性 |
StrAttr |
文字列属性を設定します。 値の長さは、最大 128 文字です。 この属性を使用して、画像検索時に画像をフィルタリングできます。 |
任意 |
- [OK] をクリックすると、 画像の追加プロセスが完了します。
API の呼び出し
この方法では、HTTP または HTTPS を使用してリクエストを送信し、画像検索にアクセスできます。署名メカニズムに基づいて認証を受ける必要があります。 リクエストの本文は、指定された形式で送信する必要があります。
デフォルトでは、API を呼び出して画像を追加する場合、1 秒あたり 5 クエリ (5 QPS) がサポートされています。 詳細については、「画像の追加」をご参照ください。
SDK の使用
Image Search には、複数バージョンの SDK が用意されています。 SDK を使用して画像を追加する場合は、署名の検証やリクエスト本文の形式などの問題について心配する必要はありません。
リアルタイムで少数の画像を追加する場合は、SDK の使用を推奨します。 SDK を使用してイメージを追加する場合、デフォルトで 5 QPS がサポートされています。
詳細については、SDKリファレンスをご参照ください。
バッチ操作の実行
ImageSearch を AlibabaCloud OSS (Object Storage Service) に接続すると、OSS から ImageSearch
に画像を一括インポートできます。 この方法は、タスクを使用して数百万の画像を追加する必要があるシナリオに適用されます。 詳細については、「バッチ操作の実行」をご参照ください。