RecognizeImageColor可以对输入图的颜色信息进行分析,给出颜色值(RGB形式和HEX格式)与对应的占比信息。

图片限制

  • 图片大小:不得超过2500x2500像素,最大为9.5 MB。
  • 图像都必须是RGB 3通道。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String RecognizeImageColor

系统规定参数。取值:RecognizeImageColor。

ColorCount Integer 5

期望的色板输出数量,范围[1, 16] ,默认值为3。

Url String https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/RecognizeImageColor/RecognizeImageColor.png

图片地址。

返回数据

名称 类型 示例值 描述
RequestId String 2A154049-CDFA-4D29-8E11-3319EB3A9967

当前请求的request id。

Data Struct

返回的数据内容。

ColorTemplateList Array

色板列表。

Color String 3996E0

RGB颜色值(16进制),如:291A18。

Label String blue

颜色标签,如:gray,red。

Percentage Float 0.372702

所占比例,取值范围[0.0, 1.0]

示例

请求示例

https://imagerecog.cn-shanghai.aliyuncs.com/?Action=RecognizeImageColor&<公共请求参数>

正常返回示例

JSON 格式

{
  "Data": {
    "ColorTemplateList": [
      {
        "Percentage": "0.372702",
        "Label": "blue",
        "Color": "3996E0"
      },
      {
        "Percentage": "0.300643",
        "Label": "yellow",
        "Color": "B68E22"
      },
      {
        "Percentage": "0.158364",
        "Label": "blue",
        "Color": "B7C4D3"
      },
      {
        "Percentage": "0.087224",
        "Label": "gray",
        "Color": "424335"
      },
      {
        "Percentage": "0.081066",
        "Label": "blue",
        "Color": "1B3859"
      }
    ]
  },
  "RequestId": "2A154049-CDFA-4D29-8E11-3319EB3A9967"
}

错误码

具体请参见常见错误码