すべてのプロダクト
Search

このプロダクト

    Image Search:画像の追加

    ドキュメントセンター

    Image Search:画像の追加

    最終更新日:Jun 23, 2026

    このトピックでは、Image Search に画像を追加する 4 つの方法について説明します。コンソールの使用 (機能評価用)、API の呼び出し、SDK の使用 (小規模なリアルタイム増分データ操作用)、一括操作の実行 (数百万枚の画像を含む大規模なオフラインデータ操作用) があります。ニーズに最適な方法を選択してください。

    前提条件

    インスタンスを作成しておく必要があります。詳細については、「Image Search のアクティブ化」をご参照ください。

    コンソール

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

    2. 左側のナビゲーションペインで、サービスタイプを選択します。このトピックでは、[商品画像検索] を例に説明します。

      サービスタイプの詳細については、「サービス」をご参照ください。

    3. 対象のインスタンスをクリックします。

      インスタンスリストで、対象のインスタンスの インスタンス ID をクリックします。2

    4. [画像の追加] を選択します。

      パラメータを設定し、[OK] をクリックします。画像の送信に成功すると、右側に生の JSON レスポンスが表示されます。成功したレスポンスには、code: 0、message: "success"、および categoryId (カテゴリ ID) と region (被写体領域の座標) を含む picInfo が含まれます。各パラメータについては、次の表で説明します。

      パラメータ

      API パラメータ

      説明

      必須

      商品 ID

      ProductId

      商品の一意の 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 の Add オペレーションのサンプルコードをご参照ください。

      はい

      画像主体認識

      Crop

      主体認識を有効または無効にします。

      はい

      認識方法

      該当なし

      主体認識の方法：

      • 自動認識： システムが自動的に被写体を認識し、認識された被写体を検索に使用します。レスポンスには認識結果が含まれます。

      • 主体領域の定義： 主体認識を有効にし、被写体領域を定義できます。被写体領域を定義しない場合、サービスは画像全体を検索します。

      はい

      画像カテゴリ

      CategoryId

      画像のカテゴリです。画像を追加する際にカテゴリを設定できます。

      説明

      1. 商品画像検索サービスには、自動カテゴリ予測機能が搭載されています。このパラメータを指定しない場合、Image Search は画像カテゴリを自動的に予測し、インデックスを作成します。予測されたカテゴリはレスポンスで返されます。

      2. 検索時に、商品画像検索サービスはクエリ画像のカテゴリも予測し、そのカテゴリ内で検索を行うことで、範囲を絞り込み、精度を向上させます。

      3. 商品画像検索サービスの場合、デフォルトの自動カテゴリ予測機能の使用を推奨します。

      4. カテゴリのリストについては、「カテゴリリファレンス」をご参照ください。

      重要

      画像を追加する際にカテゴリを指定した場合、検索時にも同じカテゴリを指定する必要があります。指定しない場合、元の画像を使用した検索で画像が見つからない可能性があります。

      いいえ

      カスタムコンテンツ

      CustomContent

      ユーザー定義のコンテンツです。最大 4,096 文字まで指定できます。

      説明

      検索結果にはこの値が含まれます。このフィールドを使用して、画像 URL やその他の追加情報を保存し、画像をビジネスデータに関連付けることができます。

      いいえ

      整数属性

      IntAttr

      検索結果のフィルタリングに使用する整数属性です。この属性は検索結果に含まれます。

      説明

      フィルタ条件に整数属性を使用して検索結果をフィルタリングします。詳細については、「フィルタ条件」をご参照ください。

      いいえ

      整数属性 2

      IntAttr2

      いいえ

      整数属性 3

      IntAttr3

      いいえ

      整数属性 4

      IntAttr4

      いいえ

      文字列属性

      StrAttr

      検索結果のフィルタリングに使用する文字列属性です。最大 128 文字まで指定できます。

      説明

      • フィルタ条件に文字列属性を使用して検索結果をフィルタリングします。詳細については、「フィルタ条件」をご参照ください。

      • \、¥、$、&、% などの特殊文字はサポートされていません。

      いいえ

      文字列属性 2

      StrAttr2

      いいえ

      文字列属性 3

      StrAttr3

      いいえ

      文字列属性 4

      StrAttr4

      いいえ

    5. [OK] をクリックして画像を追加します。

    API

    HTTP または HTTPS リクエストを送信してオペレーションを呼び出すことができます。各リクエストを署名で認証し、指定された形式でリクエストボディをフォーマットする必要があります。API で画像を追加する場合のデフォルトの QPS (クエリ/秒) は 5 です。詳細については、「AddImage」をご参照ください。

    SDK

    Image Search は、複数のプログラミング言語用の SDK を提供しています。SDK を使用すると、署名検証やリクエストボディのフォーマットなどの面倒な作業を行う必要がなくなります。この方法は、少数の画像をリアルタイムで追加する場合に推奨します。QPS 制限は、画像容量が 100,000 枚のインスタンスでは 1、その他すべてのインスタンスタイプでは 5 です。詳細については、Add オペレーションをご参照ください。

    一括操作

    Image Search は Alibaba Cloud Object Storage Service (OSS) と統合されており、いくつかの簡単な手順で OSS バケットから画像を一括インポートできます。この方法は、大規模 (数百万枚の画像) なオフラインデータインポートに適しています。詳細については、「一括操作の実行」をご参照ください。