本文介紹圖像生產(chǎn)（imageenhan）類目下的照圖修圖ImitatePhotoStyle的語法及示例。

功能描述

照圖修圖能力可以將輸入的參考圖的光照、色彩等不影響原圖結(jié)構(gòu)的風(fēng)格遷移至目標(biāo)圖。

您可以在體驗中心進(jìn)行體驗與試用。關(guān)于該接口功能的示例圖如下：

  • 原圖
  • 參考圖
  • 結(jié)果圖
說明 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等，請通過釘釘群（23109592）加入阿里云視覺智能開放平臺咨詢?nèi)郝?lián)系我們。

接入指引

1. 注冊阿里云賬號：打開阿里云官網(wǎng)，在阿里云官網(wǎng)右上角，單擊立即注冊，按照操作提示完成賬號注冊。

2. 開通能力：請確保您已開通圖像生產(chǎn)服務(wù)，若未開通服務(wù)請立即開通。

3. 創(chuàng)建AccessKey：請確保您已創(chuàng)建AccessKey，如果您使用的是子賬號AccessKey，您需要給子賬號賦予AliyunVIAPIFullAccess權(quán)限，具體操作，請參見RAM授權(quán)。

4. 在線調(diào)試（可選）：您可以通過OpenAPI Explorer在線調(diào)試能力，查看完整的調(diào)用示例代碼及SDK依賴信息，也可以下載完整的工程。

5. 開發(fā)接入步驟：

  • 在SDK總覽中選擇您要接入使用的SDK語言。
  • 在對應(yīng)語言的SDK文檔中找到AI類目為圖像生產(chǎn)（imageenhan）的SDK包進(jìn)行安裝。
  • 參考文檔中提供的示例代碼進(jìn)行適當(dāng)修改后調(diào)用。

6. 客戶端直接調(diào)用：該能力常用的客戶端調(diào)用方式包括以下幾種。

輸入限制

  • 圖像格式：JPG、JPEG、PNG。
  • 圖像大小：小于3 MB。
  • 圖像分辨率：大于32×32像素，小于3000×3000像素。
  • URL地址不能包含中文字符。

計費說明

關(guān)于照圖修圖的計費方式及報價，請參見計費介紹。

說明 下方調(diào)試接口為付費接口，如需免費體驗調(diào)試請前往體驗中心。

調(diào)試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數(shù)

名稱 類型 是否必選 示例值 描述
Action String 是 ImitatePhotoStyle

系統(tǒng)規(guī)定參數(shù)。取值：ImitatePhotoStyle。
StyleUrl String 是 http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageenhan/ImitatePhotoStyle/ImitatePhotoStyle7.jpg

參考圖URL地址。推薦使用上海地域的OSS鏈接，對于文件在本地或者非上海地域OSS鏈接的情況，請參見文件URL處理。
ImageURL String 是 http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageenhan/ImitatePhotoStyle/ImitatePhotoStyle1.jpg

需要進(jìn)行風(fēng)格變換的圖像URL地址。推薦使用上海地域的OSS鏈接，對于文件在本地或者非上海地域OSS鏈接的情況，請參見文件URL處理。

返回數(shù)據(jù)

名稱 類型 示例值 描述
RequestId String A880432B-6D9A-4EF4-B7B7-863F38A930D9

請求ID。
Data Object

返回的結(jié)果數(shù)據(jù)內(nèi)容。
ImageURL String http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/photo-style-imitation/7c4c0809-5e15-4ca7-84b3-ba16711e3255__5cb220200622-075203.jpg?Expires=1592814125&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=DNhhRFPbMBwpHCEhrLdL%2BBF%2BXs****

進(jìn)行風(fēng)格變換后的結(jié)果圖像URL地址。

說明 該URL地址為臨時地址，有效期為30分鐘，過期后將無法訪問。

SDK參考

阿里云視覺AI圖像生產(chǎn)類目下的照圖修圖能力推薦使用SDK調(diào)用，支持多種編程語言，調(diào)用時請選擇AI類目為圖像生產(chǎn)（imageenhan）的SDK包，文件參數(shù)通過SDK調(diào)用可支持本地文件及任意URL，具體可參見SDK總覽。

示例

請求示例

http(s)://imageenhan.cn-shanghai.aliyuncs.com/?Action=ImitatePhotoStyle      //更多關(guān)于訪問域名（Endpoint）信息，請參見：http://m.bestwisewords.com/document_detail/143103.html
&StyleUrl=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageenhan/ImitatePhotoStyle/ImitatePhotoStyle7.jpg
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageenhan/ImitatePhotoStyle/ImitatePhotoStyle1.jpg
&公共請求參數(shù)

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ImitatePhotoStyleResponse>
    <RequestId>A880432B-6D9A-4EF4-B7B7-863F38A930D9</RequestId>
    <Data>
        <ImageURL>http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/photo-style-imitation/7c4c0809-5e15-4ca7-84b3-ba16711e3255__5cb220200622-075203.jpg?Expires=1592814125&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=DNhhRFPbMBwpHCEhrLdL%2BBF%2BXs****</ImageURL>
    </Data>
</ImitatePhotoStyleResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "A880432B-6D9A-4EF4-B7B7-863F38A930D9",
  "Data" : {
    "ImageURL" : "http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/photo-style-imitation/7c4c0809-5e15-4ca7-84b3-ba16711e3255__5cb220200622-075203.jpg?Expires=1592814125&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=DNhhRFPbMBwpHCEhrLdL%2BBF%2BXs****"
  }
}

錯誤碼

關(guān)于照圖修圖的錯誤碼，詳情請參見常見錯誤碼。

安全聲明

  • 請確保上傳的圖片或文件來源符合相應(yīng)的法律法規(guī)。
  • 通過體驗調(diào)試上傳的臨時文件有效期為1小時，在24小時后會被系統(tǒng)自動清理刪除。