RecolorImage将输入图自动或根据指定色板进行色彩转换,同时保证视觉热点区域避免不正常拓色。

图片限制

  • 图片大小:输入图片尺寸不得超过1200x1200像素,并且大小不超过1.6 MB。
  • 图像都必须是RGB 3通道或者RGBA 4通道。

调试

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

请求参数

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

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

Mode String TEMPLATE

拓色模式。默认为AUTO。

  • AUTO:自动拓色。
  • TEMPLATE:色板拓色。
  • REF_PIC:参考图拓色。
Url String https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/RecolorImage/recolor-1-src.png

图片地址URL,输入格式:JPG/PNG。

RefUrl String https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/RecolorImage/recolor-2-src.png

参考图拓色,参考图URL。

ColorCount Integer 3

拓展色系数量,取值范围[1, 8],默认为1。

ColorTemplate.N.Color String 056A6B

色板拓色,Top主色列表,颜色值定义ARGB。如:0A0B0C,数组大小[1, 7]

说明 colorTemplate、refUrl、colorCount根据mode三选一。

返回数据

名称 类型 示例值 描述
RequestId String 3A9BFC5E-3F7C-4D9A-9445-908C6D14AB5B

当前请求的request id。

Data Struct

返回的数据内容。

ImageList List http://ivpd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/RecolorImage/recolor-1-src.png?Expires=1574600624&OSSAccessKeyId=LTAI4FeJ8qKkYn6SrHhQ1DZQ&Signature=y6MqVvFjrV9lnmhcCHZSulXOc2k%3D

拓色完成后的图片地址,输出格式PNG。

示例

请求示例

自动拓色:
{
  "url": "https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/RecolorImage/recolor-1-src.png",
  "colorCount": 3
}
参考图拓色:
{
  "url": " https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/RecolorImage/recolor-1-src.png ",
  "refUrl": "https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/RecolorImage/recolor-2-src.png ",
  "mode": "REF_PIC"
}
色板拓色
{
  "url": "https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/RecolorImage/recolor-refurl-src.png",
  "colorTemplate": [ 
    { "color": "056A6B"}, 
    { "color": "FF0000"}
  ],
  "mode": "TEMPLATE"
}

正常返回示例

JSON 格式

自动拓色
{
  "Data": {
    "ImageList": [
      "http://ivpd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/RecolorImage/recolor-1-src.png?Expires=1574600624&OSSAccessKeyId=LTAI4FeJ8qKkYn6SrHhQ1DZQ&Signature=y6MqVvFjrV9lnmhcCHZSulXOc2k%3D"
    ]
  },
  "RequestId": "77D09611-9FBC-406E-8506-405C468F310B"
}
参考图拓色
 { 
  "Data": {
    "ImageList": [
      "http://ivpd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/upload/result_/2019-11-21/invi__015743415515071000118_nBp2Ej.png?Expires=1574600751&OSSAccessKeyId=LTAI4FeJ8qKkYn6SrHhQ1DZQ&Signature=rMwWX2dRlosApH3A3DSjxwVaFKA%3D"
    ]
  },
  "RequestId": "4299F194-6F92-4939-BCD8-02FDD9EF790C"
}
色板拓色
{ 
  "Data": {
    "ImageList": [
      "http://ivpd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/upload/result_/2019-11-21/invi__015743416356921000120_bnAO7l.png?Expires=1574600835&OSSAccessKeyId=LTAI4FeJ8qKkYn6SrHhQ1DZQ&Signature=XurCY8jIvhpT58INfe8eJ7psVSs%3D"
    ]
  },
  "RequestId": "3A9BFC5E-3F7C-4D9A-9445-908C6D14AB5B"
}

错误码

具体请参见常见错误码