本文档介绍颜色识别RecognizeImageColor的语法及示例。

功能描述

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

例如输入以下图像:

前提条件

请确保您已开通图像识别服务,若未开通服务请立即开通

图片限制

  • 图片格式:PNG、JPG、JPEG、BMP。
  • 图片大小:大小不超过9.5 MB。
  • 图片分辨率:小于2500×2500像素。
  • 图像都必须是RGB 3通道。
  • URL地址中不能包含中文字符。

调试

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

请求参数

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

要执行的操作。取值:RecognizeImageColor。

ColorCount Integer 5

期望的色板输出数量。取值范围1~10,默认值为3。

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

图片URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

ColorTemplateList Array of ColorTemplate

色板列表。

Color String 3996E0

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

Label String blue

颜色标签,共11种:black、white、gray、red、orange、yellow、green、cyan、blue、purple、magenta。

Percentage Float 0.372702

当前颜色标签所占比例,取值范围[0.0, 1.0]

RequestId String 2A154049-CDFA-4D29-8E11-3319EB3A9967

请求ID。

示例

请求示例

http(s)://imagerecog.cn-shanghai.aliyuncs.com/?Action=RecognizeImageColor
&ColorCount=5
&Url=https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/RecognizeImageColor/RecognizeImageColor.png
&<公共请求参数>

正常返回示例

XML 格式

<Data>
    <ColorTemplateList>
        <Percentage>0.372702</Percentage>
        <Label>blue</Label>
        <Color>3996E0</Color>
    </ColorTemplateList>
    <ColorTemplateList>
        <Percentage>0.300643</Percentage>
        <Label>yellow</Label>
        <Color>B68E22</Color>
    </ColorTemplateList>
    <ColorTemplateList>
        <Percentage>0.158364</Percentage>
        <Label>blue</Label>
        <Color>B7C4D3</Color>
    </ColorTemplateList>
    <ColorTemplateList>
        <Percentage>0.087224</Percentage>
        <Label>gray</Label>
        <Color>424335</Color>
    </ColorTemplateList>
    <ColorTemplateList>
        <Percentage>0.081066</Percentage>
        <Label>blue</Label>
        <Color>1B3859</Color>
    </ColorTemplateList>
</Data>
<RequestId>2A154049-CDFA-4D29-8E11-3319EB3A9967</RequestId>

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"
}

错误码

关于颜色识别的错误码,详情请参见常见错误码

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。