カラー抽出

カラー抽出サービスは、画像を与えると、ピクセルカラーのヒストグラムを計算し、主要な色でバケットに並べ替えることができます。 画像ピクセルの色は、カラースペクトルを表す 40 の主色に分類されます。 次に、これらの 40 色の中から色値のヒストグラムを計算する。 サービスには次の 2 つのバリエーションがあります。

カラー抽出（全画像）

この方法は、画像全体のカラーヒストグラムを抽出します。

カラー抽出（マスク付き）

この方法では、ディープラーニングベースのフォアグラウンド抽出を使用して、フォアグラウンドのオブジェクトを識別します。 このモデルは、e コマース画像のカタログに基づいてトレーニングされます。 前景オブジェクトを抽出した後、前述のように、主要な色に対してヒストグラムを計算します。

このドキュメントの例では、次の画像を使用しています。

API 形式

POST /services/v1/predict

リクエスト

次のリクエスト例では、色抽出にフルイメージメソッドを使用しています。

次のリクエストは、ペイロードで提供された入力パラメーターに基づいて画像から色を抽出します。 表示される入力パラメーターの詳細については、ペイロード例の下の表を参照してください。

curl -i -X POST https://sensei.adobe.io/services/v1/predict \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: multipart/form-data' \
  -H 'x-api-key: {API_KEY}' \
  -H 'cache-control: no-cache,no-cache' \
  -F file=@test_image.jpg \
  -F 'contentAnalyzerRequests={
   "enable_diagnostics":"true",
   "requests":[
     {
         "analyzer_id": "Feature:image-color-histogram:Service-6fe52999293e483b8e4ae9a95f1b81a7",
         "parameters": {
          "application-id": "1234", 
          "content-type": "inline", 
          "encoding": "jpeg", 
          "threshold": "0", 
          "top-N": "0", 
          "custom": {}, 
          "data": [{
            "content-id": "0987", 
            "content": "inline-image", 
            "content-type": "inline", 
            "encoding": "jpeg", 
            "threshold": "0", 
            "top-N": "0", 
            "historic-metadata": [], 
            "custom": {"exclude_mask": 1}
            }]
          }
      }
    ]
}'

応答

正常な応答は、抽出された色の詳細を返します。 各色は feature_value キーで表され、次の情報が含まれます。

• 色名
• この色が画像に対して表示される割合
• 色のRGB値

以下の最初の例のオブジェクトでは、 White,0.59,251,251,243 の feature_value は、見つかった色が白で、白は画像の 59%で、RGB値は 251,251,243 です。

{
  "status": 200,
  "content_id": "test_image.jpg",
  "cas_responses": [
    {
      "status": 200,
      "analyzer_id": "Feature:image-color-histogram:Service-e952f4acd7c2425199b476a2eb459635",
      "content_id": "test_image.jpg",
      "result": {
        "response_type": "feature",
        "response": [
          {
            "feature_value": [
              {
                "feature_name": "color_name_and_rgb",
                "feature_value": "White,0.59,251,251,243"
              },
              {
                "feature_value": "Orange,0.30,248,169,48",
                "feature_name": "color_name_and_rgb"
              },
              {
                "feature_name": "color_name_and_rgb",
                "feature_value": "Mustard,0.08,251,199,77"
              },
              {
                "feature_name": "color_name_and_rgb",
                "feature_value": "Gold,0.02,250,191,55"
              }
            ],
            "feature_name": "color"
          }
        ]
      }
    }
  ],
  "error": []
}