颜色提取

注意

Content and Commerce AI 是测试版。 文档可能会发生更改。

当给定图像时，颜色提取服务可以计算像素颜色的直方图，并按主色对它们进行分段。 图像像素中的颜色被分段为40种主要颜色，它们代表颜色谱。 然后，在这40种颜色中计算颜色值的直方图。 该服务有两个变体：

颜色提取（完整图像）

此方法可提取整个图像的颜色直方图。

颜色提取（带有蒙版）

该方法采用基于深度学习的前景提取器对前景中的目标进行识别。 该模型在电子商务图像目录上进行培训。 一旦提取前景对象，就像先前描述的那样在主色上计算直方图。

本文档所示的示例使用了下图：

测试图像

API格式

POST /services/v1/predict

请求

以下示例请求使用全图像方法进行颜色提取。

以下请求基于有效载荷中提供的输入参数从图像中提取颜色。 有关所示输入参数的更多信息，请参阅有效负载示例下表。

注意

analyzer_id 确定 Sensei Content Framework 中，将使用。 请检查您是否拥有 analyzer_id 之前。 对于颜色提取服务， analyzer_id ID是：
Feature:image-color-histogram:Service-6fe52999293e483b8e4ae9a95f1b81a7

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}
            }]
          }
      }
    ]
}'
属性 描述 必需
analyzer_id 的 Sensei 请求部署在下的服务ID。 此ID确定 Sensei Content Frameworks 中，将使用。 对于自定义服务，请联系内容和商务AI团队以设置自定义ID。 是
application-id 创建的应用程序的ID。 是
data 包含JSON对象的数组。 数组中的每个对象都表示一个图像。 作为此数组的一部分传递的任何参数都会覆盖在 data 数组。 下表中列出的任何其余属性都可以从中覆盖 data. 是
content-id 响应中返回的数据元素的唯一ID。 如果未传递，则会分配一个自动生成的ID。 否
content 颜色提取服务要分析的内容。 如果图像是请求正文的一部分，请使用 -F file=@<filename> 在用于传递图像的curl命令中，将此参数保留为空字符串。
如果图像是S3上的文件，请传递带签名的url。 当内容是请求正文的一部分时，数据元素列表应该只有一个对象。 如果传递了多个对象，则仅处理第一个对象。		 是
content-type 用于指示输入是请求正文的一部分还是S3存储段的带符号的url。 此属性的默认值为 inline. 否
encoding 输入图像的文件格式。 当前只能处理JPEG和PNG图像。 此属性的默认值为 jpeg. 否
threshold 需要返回结果的分数阈值（0到1）。 使用值 0 返回所有结果。 此属性的默认值为 0. 否
top-N 要返回的结果数（不能是负整数）。 使用值 0 返回所有结果。 与 threshold，则返回的结果数是任一限制集中的较小者。 此属性的默认值为 0. 否
custom 要传递的任何自定义参数。 否
historic-metadata 可以传递元数据的数组。 否

响应

成功的响应会返回提取颜色的详细信息。 每种颜色由 feature_value 键，其中包含以下信息：

  • 颜色名称
  • 此颜色相对于图像显示的百分比
  • 颜色的RGB值

在下面的第一个示例对象中， feature_value of White,0.59,251,251,243 表示找到的颜色为白色，在图像的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": []
}
属性 描述
content_id 在您的POST请求中上传的图像的名称。
feature_value 其对象包含具有相同属性名称的键的数组。 这些键包含一个表示颜色名称的字符串，此颜色相对于在 content_id、和颜色的RGB值。

在此页面上