本文介紹圖像生產(imageenhan)類目下的色彩遷移RecolorImage的語法及示例。
功能描述
色彩遷移能力將輸入圖自動或根據指定色板進行色彩轉換,同時避免視覺熱點區域不正常拓色。
關于該接口功能的示例圖如下:
模式說明
-
自動拓色
輸入要拓色的結果數量,即拓展色系數量,算法根據色彩空間計算均勻采樣方式,給出符合數量要求的拓色結果。簡單來講,就是色系數量是幾,就輸出幾張圖片。
例如下面圖1為原圖,圖2為色系數量設置為3的拓色結果,圖3為色系數量設置為6的拓色結果。
-
色板拓色
輸入一組顏色列表(色板),算法以色板為主色對原圖進行拓色。該模式提供了更強的色彩控制能力。顏色列表的長度不得超過規定數值。
例如輸入
[#0000FF, #00FF00, #FF0000]
,即[純紅,純綠,純藍]
,則拓色結果如下。 -
參考圖拓色
您提供一個參考圖,算法會根據參考圖對原圖進行拓色。
例如給出的參考圖如下:
拓色結果為:
接入指引
1. 注冊阿里云賬號:打開阿里云官網,在阿里云官網右上角,單擊立即注冊,按照操作提示完成賬號注冊。
2. 開通能力:請確保您已開通圖像生產服務,若未開通服務請立即開通。
3. 創建AccessKey:請確保您已創建AccessKey,如果您使用的是子賬號AccessKey,您需要給子賬號賦予AliyunVIAPIFullAccess權限,具體操作,請參見RAM授權。
4. 在線調試(可選):您可以通過OpenAPI Explorer在線調試能力,查看完整的調用示例代碼及SDK依賴信息,也可以下載完整的工程。
5. 開發接入步驟:
- 在SDK總覽中選擇您要接入使用的SDK語言。
- 在對應語言的SDK文檔中找到AI類目為圖像生產(imageenhan)的SDK包進行安裝。
- 參考文檔中提供的示例代碼進行適當修改后調用。
6. 示例代碼:該能力常用語言的示例代碼,請參見色彩遷移示例代碼。
7. 客戶端直接調用:該能力常用的客戶端調用方式包括以下幾種。
輸入限制
- 圖像格式:JPEG、JPG、PNG、BMP。
- 圖像大小:不超過3 MB。
- 圖像分辨率:大于64×64像素,小于1200×1200像素。
- 圖像都必須是RGB 3通道或者RGBA 4通道。
- 圖像顏色應避免基本是黑白灰色。
- URL地址中不能包含中文字符。
計費說明
關于色彩遷移的計費方式及報價,請參見計費介紹。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | RecolorImage | 系統規定參數。取值:RecolorImage。 |
Url | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageenhan/RecolorImage/RecolorImage-REF_PIC1.jpg | 圖像URL地址。推薦使用上海地域的OSS鏈接,對于文件在本地或者非上海地域OSS鏈接的情況,請參見文件URL處理。 |
Mode | String | 否 | TEMPLATE | 拓色模式。默認為AUTO。
|
RefUrl | String | 否 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageenhan/RecolorImage/RecolorImage-REF_PIC7.jpg | 參考圖拓色。參考圖的URL地址。推薦使用上海地域的OSS鏈接,對于文件在本地或者非上海地域OSS鏈接的情況,請參見文件URL處理。 |
ColorCount | Integer | 否 | 3 | 拓展色系數量,取值范圍1~8,默認為1。 |
ColorTemplate.N.Color | String | 否 | 056A6B | 色板拓色,Top主色列表,顏色值定義ARGB。如:0A0B0C,數組大小 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 3A9BFC5E-3F7C-4D9A-9445-908C6D14AB5B | 請求ID。 |
Data | Object | 返回的結果數據內容。 |
|
ImageList | Array of String | http://ivpd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/RecolorImage/recolor-1-src.png?Expires=1574600624&OSSAccessKeyId=LTAI4FeJ8qKkYn6SrHhQ****&Signature=y6MqVvFjrV9lnmhcCHZSulXOc2**** | 拓色完成后的圖像URL地址,圖像格式為PNG。 說明 該URL地址為臨時地址,有效期為30分鐘,過期后將無法訪問。若需要長時間或者永久保存文件,請在30分鐘內訪問URL地址,下載文件轉存到自己的OSS或者其他存儲空間。 |
SDK參考
阿里云視覺AI圖像生產類目下的色彩遷移能力推薦使用SDK調用,支持多種編程語言,調用時請選擇AI類目為圖像生產(imageenhan)的SDK包,文件參數通過SDK調用可支持本地文件及任意URL,具體可參見SDK總覽。
示例代碼
該能力常用語言的示例代碼,請參見色彩遷移示例代碼。
示例
請求示例
自動拓色:
http(s)://imageenhan.cn-shanghai.aliyuncs.com/?Action=RecolorImage //更多關于訪問域名(Endpoint)信息,請參見:http://bestwisewords.com/document_detail/143103.html
&ColorCount=3
&Url=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageenhan/RecolorImage/RecolorImage-REF_PIC1.jpg
&<公共請求參數>
參考圖拓色:
http(s)://imageenhan.cn-shanghai.aliyuncs.com/?Action=RecolorImage //更多關于訪問域名(Endpoint)信息,請參見:http://bestwisewords.com/document_detail/143103.html
&Url=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageenhan/RecolorImage/RecolorImage-REF_PIC1.jpg
&refUrl=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageenhan/RecolorImage/RecolorImage-REF_PIC7.jpg
&Mode=REF_PIC
&<公共請求參數>
色板拓色:
http(s)://imageenhan.cn-shanghai.aliyuncs.com/?Action=RecolorImage //更多關于訪問域名(Endpoint)信息,請參見:http://bestwisewords.com/document_detail/143103.html
&Url=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageenhan/RecolorImage/RecolorImage-REF_PIC1.jpg
&Mode=TEMPLATE
&ColorTemplate.1.Color=056A6B
&ColorTemplate.2.Color=FF0000
&<公共請求參數>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
自動拓色
<RecolorImageResponse>
<Data>
<ImageList>http://ivpd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/RecolorImage/recolor-1-src.png?Expires=1574600624&OSSAccessKeyId=LTAI4FeJ8qKkYn6SrHhQ****&Signature=y6MqVvFjrV9lnmhcCHZSulXOc2****</ImageList>
</Data>
<RequestId>77D09611-9FBC-406E-8506-405C468F310B</RequestId>
</RecolorImageResponse>
參考圖拓色
<RecolorImageResponse>
<Data>
<ImageList>http://ivpd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/upload/result_/2019-11-21/invi__015743415515071000118_nBp2Ej.png?Expires=1574600751&OSSAccessKeyId=LTAI4FeJ8qKkYn6SrHhQ****&Signature=rMwWX2dRlosApH3A3DSjxwVaFK****</ImageList>
</Data>
<RequestId>4299F194-6F92-4939-BCD8-02FDD9EF790C</RequestId>
</RecolorImageResponse>
色板拓色
<RecolorImageResponse>
<Data>
<ImageList>http://ivpd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/upload/result_/2019-11-21/invi__015743416356921000120_bnAO7l.png?Expires=1574600835&OSSAccessKeyId=LTAI4FeJ8qKkYn6SrHhQ****&Signature=XurCY8jIvhpT58INfe8eJ7psVS****</ImageList>
</Data>
<RequestId>3A9BFC5E-3F7C-4D9A-9445-908C6D14AB5B</RequestId>
</RecolorImageResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
自動拓色
{
"Data": {
"ImageList": [
"http://ivpd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/RecolorImage/recolor-1-src.png?Expires=1574600624&OSSAccessKeyId=LTAI4FeJ8qKkYn6SrHhQ****&Signature=y6MqVvFjrV9lnmhcCHZSulXOc2****"
]
},
"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=LTAI4FeJ8qKkYn6SrHhQ****&Signature=rMwWX2dRlosApH3A3DSjxwVaFK****"
]
},
"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=LTAI4FeJ8qKkYn6SrHhQ****&Signature=XurCY8jIvhpT58INfe8eJ7psVS****"
]
},
"RequestId": "3A9BFC5E-3F7C-4D9A-9445-908C6D14AB5B"
}
錯誤碼
關于色彩遷移的錯誤碼,詳情請參見常見錯誤碼。
安全聲明
- 請確保上傳的圖片或文件來源符合相應的法律法規。
- 通過體驗調試上傳的臨時文件有效期為1小時,在24小時后會被系統自動清理刪除。