图片主题颜色抽取

服务简介 :

本服务可以识别抽取上传图片的主要颜色, 从而用户可获取用文字描述的输入图片的主题颜色名称。 这有助于对图片的管理及有关颜色的查询。本服务支持自动去除比较简单的背景干扰以便提取图片主要目标物的主要颜色。

应用场景 :

图像库交易平台, 图片素材网站, 图片社区网站, 图片分享APP, 照片图片管理网站及APP。



接口地址 : http://api1.wozhitu.com:8084/vsearchtech/imgPnpRest/extractcolor

图片格式要求: JPG格式300 – 1200 像素图片

请求方法 :POST

请求参数(body) :

参数名 类型 必填 参数位置 描述 默认值
apikey string body API密钥
fmt string body 返回结果格式: json或xml json
numofcolor int body 抽取多少个细分颜色 5
bgrdrm int body 是否去除背景干扰以便提取图片主要目标物的主要颜色
1 - 去除背景
0 – 不去除背景
0 不做自动去除背景

参数名 类型 必填 参数位置 描述 默认值
photo file body 图片文件


详细使用教程



接口地址 : http://api1.wozhitu.com:8084/vsearchtech/imgPnpRest/extractcolor

图片格式要求: JPG格式300 – 1200 像素图片

请求方法 : POST

请求参数(body) :

参数名 类型 必填 参数位置 描述 默认值
apikey string body API密钥
fmt string body 返回结果格式: json或xml json
imgURL string body 图片地址URL
numofcolor int body 抽取多少个细分颜色 5
bgrdrm int body 是否去除背景干扰以便提取图片主要目标物的主要颜色
1 - 去除背景
0 – 不去除背景
0 不做自动去除背景


JSON返回示例(返回的weight表示此颜色的权重):

[{"class":"vs.vscore.colorextract.ApiColorExtractResultEntry","clrName":"Olive|橄榄绿(ExactName:OliveDrab)","rgbHexString":"#798d2c","rgbString":"rgb(121,141,44)","weight":0.4548114},{"class":"vs.vscore.colorextract.ApiColorExtractResultEntry","clrName":"Silver|银(ExactName:Gainsboro)","rgbHexString":"#e3dcdb","rgbString":"rgb(227,220,219)","weight":0.30173904},{"class":"vs.vscore.colorextract.ApiColorExtractResultEntry","clrName":"Black|黑(ExactName:DarkSlateGray)","rgbHexString":"#303416","rgbString":"rgb(48,52,22)","weight":0.23812395},{"class":"vs.vscore.colorextract.ApiColorExtractResultEntry","clrName":"Silver|银(ExactName:Tan)","rgbHexString":"#c7b695","rgbString":"rgb(199,182,149)","weight":0.003215477},{"class":"vs.vscore.colorextract.ApiColorExtractResultEntry","clrName":"Green|绿(ExactName:DarkOliveGreen)","rgbHexString":"#3c542c","rgbString":"rgb(60,84,44)","weight":0.002110157}]



下载Java相关资源
下载Python相关资源
下载Php相关资源

错误码参照:


限制类错误:
API_CODE_ERROR_exceeded_access_total 用户总调用量超限
API_CODE_ERROR_exceeded_access_frequency 用户调用频度超限
API_CODE_ERROR_exceeded_access_frequency_min 服务每分钟调用量超限
API_CODE_ERROR_exceeded_access_frequency_hr 服务每小时调用量超限
API_CODE_ERROR_exceeded_access_frequency_day 用户日调用量超限
API_CODE_ERROR_exceeded_access_frequency_month 服务每月调用量超限
API_CODE_ERROR_two_API_calls_time_too_close 两次调用时间太近

调用方法错误:
API_CODE_ERROR_invalid_apikey Apikey错误
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_imgName 图片名错误
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_imgUrl 图片URL错误
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_LANG 语言参数错误(中文zh 或英语en)
IMAGE_INDEX_CODE_ERROR_IMAGE_SIZE_TOO_BIG 图片太大(最好在400 – 800PIX JPG 图片)