顏色標籤
指定影像時，顏色標籤服務可以計算畫素顏色的色階分佈圖，並依主色排序成色桶。 影像畫素中的顏色會分成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
8959a20a-a58f-4057-9f82-870706c576e9