颜色标记

当给定图像时,颜色标记服务可以计算像素颜色的直方图,并按主颜色将它们排序成存储桶。 图像像素中的颜色被分成40种主要颜色,这些主要颜色代表色谱。 然后在这40种颜色中计算颜色值的直方图。 该服务具有两个变体:

颜色标记(完整图像)

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

颜色标记(带有蒙版)

该方法使用基于深度学习的前台提取器来识别前景中的对象。 一旦提取了前景对象,就通过前景和背景区域的主色以及整个图像计算直方图。

音调提取

除了上述变体之外,您还可以配置服务以检索以下项目的色调直方图:

  • 整体图像(使用完整图像变量时)
  • 整个图像以及前景和背景区域(使用带有蒙版的变体时)

在本文档中显示的示例中使用了以下图像:

测试映像

API格式

POST /services/v2/predict

请求 — 完整图像变体

以下示例请求使用全图像方法进行颜色标记,并根据有效负载中提供的输入参数从图像提取颜色。 有关显示的输入参数的更多信息,请参阅示例有效负载下方的表。

curl -w'\n' -i -X POST https://sensei.adobe.io/services/v2/predict \
-H 'Prefer: respond-async, wait=59' \
-H "x-api-key: $API_KEY" \
-H "content-type: multipart/form-data" \
-H "authorization: Bearer $API_TOKEN" \
-F 'contentAnalyzerRequests={
  "sensei:name": "Feature:autocrop:Service-af865523d46547e2b17fdf9b38e32a72",
  "sensei:invocation_mode": "synchronous",
  "sensei:invocation_batch": false,
  "sensei:engines": [
    {
      "sensei:execution_info": {
        "sensei:engine": "Feature:autocrop:Service-af865523d46547e2b17fdf9b38e32a72"
      },
      "sensei:inputs": {
        "documents": [{
            "sensei:multipart_field_name": "infile_1",
            "dc:format": "image/jpg"
          }]
      },
      "sensei:params": {
        "top_n": 5,
        "min_coverage": 0.005
      },
      "sensei:outputs":{
        "result" : {
          "sensei:multipart_field_name" : "result",
          "dc:format": "application/json"
        }
      }
    }
  ]
}' \
-F 'infile_1=@1431RDMJANELLERAWJACKE_2.jpg'

响应 — 完整图像变体

成功的响应将返回提取颜色的详细信息。 每种颜色由feature_value键表示,该键包含以下信息:

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

"White":{"coverage":0.5834,"rgb":{"red":254,"green":254,"blue":243}}表示找到的颜色为白色,该颜色位于图像的58.34%中,平均RGB值为254、254、243。

{
    "statuses": [{
        "sensei:engine": "Feature:autocrop:Service-af865523d46547e2b17fdf9b38e32a72",
        "invocations": [{
            "sensei:outputs": {
                "result": {
                    "sensei:multipart_field_name": "result",
                    "dc:format": "application/json"
                }
            },
            "message": null,
            "status": "200"
        }]
    }],
    "request_id": "bfpzaJxKDxtgxpjUj5QDrN1jasjUw2RM"
}

[{
    "overall": {
        "colors": {
            "White": {
                "coverage": 0.5834,
                "rgb": {
                    "red": 254,
                    "green": 254,
                    "blue": 243
                }
            },
            "Orange": {
                "coverage": 0.254,
                "rgb": {
                    "red": 249,
                    "green": 165,
                    "blue": 45
                }
            },
            "Gold": {
                "coverage": 0.0817,
                "rgb": {
                    "red": 253,
                    "green": 188,
                    "blue": 58
                }
            },
            "Mustard": {
                "coverage": 0.0727,
                "rgb": {
                    "red": 253,
                    "green": 207,
                    "blue": 84
                }
            },
            "Cream": {
                "coverage": 0.0082,
                "rgb": {
                    "red": 253,
                    "green": 236,
                    "blue": 174
                }
            }
        }
    }
}]

请注意,此处的结果已在“整体”图像区域上提取了颜色。

请求 — 蒙版图像变体

以下示例请求使用掩码方法进行颜色标记。 通过在请求中将enable_mask参数设置为true来启用此功能。

curl -w'\n' -i -X POST https://sensei.adobe.io/services/v2/predict \
-H 'Prefer: respond-async, wait=59' \
-H "x-api-key: $API_KEY" \
-H "content-type: multipart/form-data" \
-H "authorization: Bearer $API_TOKEN" \
-F 'contentAnalyzerRequests={
  "sensei:name": "Feature:autocrop:Service-af865523d46547e2b17fdf9b38e32a72",
  "sensei:invocation_mode": "synchronous",
  "sensei:invocation_batch": false,
  "sensei:engines": [
    {
      "sensei:execution_info": {
        "sensei:engine": "Feature:autocrop:Service-af865523d46547e2b17fdf9b38e32a72"
      },
      "sensei:inputs": {
        "documents": [{
            "sensei:multipart_field_name": "infile_1",
            "dc:format": "image/jpg"
          }]
      },
      "sensei:params": {
        "top_n": 5,
        "min_coverage": 0.005,
        "enable_mask": true,
        "retrieve_tone": true
      },
      "sensei:outputs":{
        "result" : {
          "sensei:multipart_field_name" : "result",
          "dc:format": "application/json"
        }
      }
    }
  ]
}' \
-F 'infile_1=@1431RDMJANELLERAWJACKE_2.jpg'
NOTE
此外,在上述请求中,retrieve_tone参数也设置为true。 这使我们能够在图像的整体、前景和背景区域中检索暖色、中性色和冷色的色调分布直方图。

响应 — 蒙版图像变体

{
    "statuses": [{
        "sensei:engine": "Feature:autocrop:Service-af865523d46547e2b17fdf9b38e32a72",
        "invocations": [{
            "sensei:outputs": {
                "result": {
                    "sensei:multipart_field_name": "result",
                    "dc:format": "application/json"
                }
            },
            "message": null,
            "status": "200"
        }]
    }],
    "request_id": "gpeCyJsrJvOWd94WwZOyPBPrKi2BQyla"
}


[{
    "overall": {
        "colors": {
            "White": {
                "coverage": 0.5834,
                "rgb": {
                    "red": 254,
                    "green": 254,
                    "blue": 243
                }
            },
            "Orange": {
                "coverage": 0.254,
                "rgb": {
                    "red": 249,
                    "green": 165,
                    "blue": 45
                }
            },
            "Gold": {
                "coverage": 0.0817,
                "rgb": {
                    "red": 253,
                    "green": 188,
                    "blue": 58
                }
            },
            "Mustard": {
                "coverage": 0.0727,
                "rgb": {
                    "red": 253,
                    "green": 207,
                    "blue": 84
                }
            },
            "Cream": {
                "coverage": 0.0082,
                "rgb": {
                    "red": 253,
                    "green": 236,
                    "blue": 174
                }
            }
        },
        "tones": {
            "warm": 0.4084,
            "neutral": 0.5916,
            "cool": 0
        }
    },
    "foreground": {
        "colors": {
            "Orange": {
                "coverage": 0.6022,
                "rgb": {
                    "red": 249,
                    "green": 165,
                    "blue": 45
                }
            },
            "Gold": {
                "coverage": 0.1935,
                "rgb": {
                    "red": 253,
                    "green": 188,
                    "blue": 58
                }
            },
            "Mustard": {
                "coverage": 0.1722,
                "rgb": {
                    "red": 253,
                    "green": 207,
                    "blue": 84
                }
            },
            "Cream": {
                "coverage": 0.0173,
                "rgb": {
                    "red": 253,
                    "green": 235,
                    "blue": 170
                }
            },
            "Yellow": {
                "coverage": 0.0148,
                "rgb": {
                    "red": 254,
                    "green": 229,
                    "blue": 117
                }
            }
        },
        "tones": {
            "warm": 0.9827,
            "neutral": 0.0173,
            "cool": 0
        }
    },
    "background": {
        "colors": {
            "White": {
                "coverage": 0.9923,
                "rgb": {
                    "red": 254,
                    "green": 254,
                    "blue": 243
                }
            },
            "Dark_Brown": {
                "coverage": 0.0077,
                "rgb": {
                    "red": 83,
                    "green": 68,
                    "blue": 57
                }
            }
        },
        "tones": {
            "warm": 0,
            "neutral": 1.0,
            "cool": 0
        }
    }
}]

除了来自整个图像的颜色之外,您现在还可以看到来自前景和背景区域的颜色。 由于已针对上述每个区域启用色调检索,因此您还可以检索色调的直方图。

输入参数

名称
数据类型
必需
默认
描述
documents
数组(Document-Object)
-
请参阅下文
JSON元素列表,列表中的每一项代表一个文档。
top_n
数字
0
非负整数
要返回的结果数。 0,返回所有结果。 当与阈值一起使用时,返回的结果数将小于任一限制。
min_coverage
数字
0.05
实数
覆盖的阈值,超过该阈值需要返回结果。 排除参数以返回所有结果。
resize_image
数字
True
真/假
是否调整输入图像的大小。 默认情况下,在执行颜色提取之前,图像大小将调整为320*320像素。 出于调试目的,我们还可以允许代码在完整映像上运行,方法是将此参数设置为False
enable_mask
数字
False
真/假
启用/禁用颜色提取
retrieve_tone
数字
False
真/假
启用/禁用音调提取

文档对象

名称
数据类型
必需
默认
描述
repo:path
字符串
-
-
-
文档的预签名URL。
sensei:repoType
字符串
-
-
HTTPS
存储映像的存储库类型。
sensei:multipart_field_name
字符串
-
-
-
将图像文件作为多部分参数传递时,请使用此选项,而不是使用预签名URL。
dc:format
字符串
-
"image/jpg",
"image/jpeg",
"image/png",
"image/tiff"
在处理之前,将根据允许的输入编码类型检查图像编码。
recommendation-more-help
8959a20a-a58f-4057-9f82-870706c576e9