本文介紹人臉人體（facebody）類目下的智能美膚RetouchSkin的語法及示例。

功能描述

智能美膚功能可實現輸入一張人物圖像，自動對臉部以及全身皮膚進行美膚，同時盡可能的保留皮膚質感。功能支持情況如下：

  • 臉部美膚：臉部區域勻膚、去瑕疵，比如：痘、痘印、雀斑等。
  • 全身皮膚：全身皮膚區域美白。
  • 多人照片：支持不超過10人的多人圖片處理。

關于該接口功能的示例圖如下：

  • 輸入原圖
  • 輸出結果圖
說明
  • 您可以進入在線咨詢獲取在線人工幫助。
  • 當前能力可在視覺智能開放平臺有完整的免費產品體驗，您可以單擊立即試用對該能力進行更直觀試用以及在線購買。
  • 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等，請通過釘釘群（23109592）加入阿里云視覺智能開放平臺咨詢群聯系我們。

應用場景

  • 專業修圖：可用于影樓、電商、圖片直播等專業攝影場景，利用智能美膚算法快速進行美膚修圖，提高工作效率。
  • 美顏拍攝：用于娛樂、生活等場景，提高人物美觀度。

特色優勢

  • 保留皮膚質感：使用深度學習算法，實現精準美膚，皮膚光滑有質感。
  • 保持背景穩定：僅對裸露的皮膚區域進行修飾，不影響背景區域。
  • 支持多人美膚：支持單張圖像中多人的美膚。

接入指引

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

2. 開通能力：請確保您已開通人臉人體服務，若未開通服務請立即開通。

說明 本能力支持企業或個人認證用戶開通。更多實名認證操作信息，請參見實名認證。

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

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

5. 開發接入步驟：

  • 在SDK總覽中選擇您要接入使用的SDK語言。
  • 在對應語言的SDK文檔中找到AI類目為人臉人體（facebody）的SDK包進行安裝。
  • 參考文檔中提供的示例代碼進行適當修改后調用。

6. 示例代碼：該能力常用語言的示例代碼，請參見智能美膚示例代碼。

7. 客戶端直接調用：該能力常用的客戶端調用方式包括以下幾種。

輸入限制

  • 圖像格式：JPEG、JPG、PNG。
  • 圖像大小：不超過6 MB。
  • 圖像分辨率：大于128×128像素，小于等于5000×5000像素，最長邊小于等于5000像素。
  • 圖像內容：包含1～10個人像，且皮膚占比明顯的照片。
  • URL地址中不能包含中文字符。
說明 當圖像分辨率超過最大限制時，請先將圖片進行縮放，調整圖片大小，具體請參見圖片縮放。

計費說明

關于智能美膚的計費方式及報價，請參見計費介紹。

調試

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

請求參數

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

系統規定參數。取值：RetouchSkin。
ImageURL String 是 http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RetouchSkin/RetouchSkin3.png

圖像URL地址。推薦使用上海地域的OSS鏈接，對于文件在本地或者非上海地域OSS鏈接的情況，請參見文件URL處理。

圖片格式要求：

  • 圖像格式：JPEG、JPG、PNG。
  • 圖像大小：不超過6 MB。
  • 圖像分辨率：大于128×128像素，小于等于5000×5000像素，最長邊小于等于5000像素。
  • 圖像內容：包含1～10個人像，且皮膚占比明顯的照片。
  • URL地址中不能包含中文字符。
說明 圖像內容：當圖像分辨率超過最大限制時，請先將圖片進行縮放，調整圖片大小，具體請參見圖片縮放。
RetouchDegree Float 否 1.0

磨皮力度。取值范圍為[0,1.5]，默認為1.0。數值越大皮膚紋理越不明顯。
WhiteningDegree Float 否 1.0

美白力度。取值范圍為[0,1.5]，默認為1.0。數值越大皮膚越白。

返回數據

名稱 類型 示例值 描述
RequestId String FD2BF3DF-3D98-1D5D-85BB-C8EC3A9FE347

請求ID。
Data Object

返回的數據內容。
ImageURL String http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/skin-retouch/FD2BF3DF-3D98-1D5D-85BB-C8EC3A9FE347_3467_20210923-094238.jpg?Expires=1632391959&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=jXJcFTv3no7Gx%2BLuPvANhRSnc2****

美膚后圖像的URL地址。

說明 該URL地址為臨時地址，有效期為30分鐘，過期后將無法訪問。若需要長時間或者永久保存文件，請在30分鐘內訪問URL地址，下載文件轉存到自己的OSS或者其他存儲空間。

SDK參考

阿里云視覺AI人臉人體類目下的智能美膚能力推薦使用SDK調用，支持多種編程語言，調用時請選擇AI類目為人臉人體（facebody）的SDK包，文件參數通過SDK調用可支持本地文件及任意URL，具體可參見SDK總覽。

示例代碼

該能力常用語言的示例代碼，請參見智能美膚示例代碼。

示例

請求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=RetouchSkin      //更多關于訪問域名（Endpoint）信息，請參見：http://m.bestwisewords.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RetouchSkin/RetouchSkin3.png
&RetouchDegree=1.0
&WhiteningDegree=1.0
&公共請求參數

正常返回示例

XML格式

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

<RetouchSkinResponse>
    <RequestId>FD2BF3DF-3D98-1D5D-85BB-C8EC3A9FE347</RequestId>
    <Data>
        <ImageURL>http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/skin-retouch/FD2BF3DF-3D98-1D5D-85BB-C8EC3A9FE347_3467_20210923-094238.jpg?Expires=1632391959&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=jXJcFTv3no7Gx%2BLuPvANhRSnc2****</ImageURL>
    </Data>
</RetouchSkinResponse>

JSON格式

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

{
  "RequestId" : "FD2BF3DF-3D98-1D5D-85BB-C8EC3A9FE347",
  "Data" : {
    "ImageURL" : "http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/skin-retouch/FD2BF3DF-3D98-1D5D-85BB-C8EC3A9FE347_3467_20210923-094238.jpg?Expires=1632391959&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=jXJcFTv3no7Gx%2BLuPvANhRSnc2****"
  }
}

錯誤碼

關于智能美膚的錯誤碼，詳情請參見常見錯誤碼。

安全聲明

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