颜色标记
当给定图像时，颜色标记服务可以计算像素颜色的直方图，并按主颜色将它们排序成存储桶。 图像像素中的颜色被分成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”
“image/jpeg”，
“image/png”，
“image/tiff”
在处理之前，将根据允许的输入编码类型检查图像编码。
recommendation-more-help
experience-platform-help-intelligent-services