本文介绍高清色彩迁移RecolorHDImage的语法及示例。

功能描述

RecolorHDImage用于对高清图像进行颜色拓色,并能够保证人像部分颜色不发生变化。该接口与色彩迁移相比:

  • 支持高清图。
  • 支持自定义拓色程度。
  • 支持人像色彩保持。

效果示例如下

前提条件

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

输入限制

  • 图片格式:PNG、JPG、JPEG。
  • 图片分辨率:分辨率要求小于10000×10000像素。
  • 图像必须是RGB 3通道。

调试

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

请求参数

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

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

Degree String 0.4

拓色程度。取值范围0~1。

Mode String REF_PIC

拓色模式。包括:

  • AUTO:自动拓色。
  • TEMPLATE:色板拓色。
  • REF_PIC:参考图拓色。
Url String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/HD.png

待拓色的图片URL地址。

RefUrl String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/zhangchaorun/%E5%8A%A8%E7%89%A9.bmp

拓色时参考图片的URL地址。

ColorCount Integer 2

拓展色系数量,取值范围1~8。

ColorTemplate.N.Color String [3F6A6B,0A0A6F]

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

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

ImageList List http://viapi-cn-shanghai-dha-filter.oss-cn-shanghai.aliyuncs.com/upload/recoloring-hd-2020-06-22-19-39-25-798c9cb57f-v6pj4/2020-6-23/invi_filter_015928996015951000042_EBPBLN.jpg?Expires=1592901401&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=ICWehJZ1tjpz6qDFVONv5%2Fyvbo****

返回拓色后的图片URL地址。

RequestId String 9364CEB1-1C39-489F-B6DB-6E65577429F1

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=RecolorHDImage
&Degree=0.4
&Mode=REF_PIC
&Url=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/HD.png
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>9364CEB1-1C39-489F-B6DB-6E65577429F1</RequestId>
<Data>
    <ImageList>http://viapi-cn-shanghai-dha-filter.oss-cn-shanghai.aliyuncs.com/upload/recoloring-hd-2020-06-22-19-39-25-798c9cb57f-v6pj4/2020-6-23/invi_filter_015928996015951000042_EBPBLN.jpg?Expires=1592901401&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=ICWehJZ1tjpz6qDFVONv5%2Fyvbo****</ImageList>
</Data>

JSON 格式

{
    "RequestId": "9364CEB1-1C39-489F-B6DB-6E65577429F1",
    "Data": {
        "ImageList": "http://viapi-cn-shanghai-dha-filter.oss-cn-shanghai.aliyuncs.com/upload/recoloring-hd-2020-06-22-19-39-25-798c9cb57f-v6pj4/2020-6-23/invi_filter_015928996015951000042_EBPBLN.jpg?Expires=1592901401&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=ICWehJZ1tjpz6qDFVONv5%2Fyvbo****"
    }
}

查询任务结果

该接口为异步接口,当前并未返回真实的请求结果,您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见查询异步任务结果

错误码

关于高清色彩迁移的错误码,详情请参见常见错误码

SDK参考

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

安全声明

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