本文介紹人臉人體（facebody）類目下的人臉美妝FaceMakeup的語法及示例。

功能描述

人臉美妝能力可以模擬彩妝，通過添加彩妝素材，進一步提升人臉美化效果，本功能支持不同風格的妝容選擇。

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

  • 輸入原圖
  • 整妝

我們還提供了不同的整妝風格供您使用，如下所示。

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

應用場景

  • 在線試妝：可用于在線試妝等虛擬試妝場景，用戶可體驗接近本人真實情況的上妝效果，降低商家的運營成本。
  • 美顏修圖：可用于手機自拍修圖等人像美化場景，一鍵實現美妝效果，幫助用戶快速打造精致五官，提升個人社交形象。
  • 直播短視頻：在直播間的主播們，通過人臉美妝技術實現一鍵上妝，吸引更多粉絲關注。
  • 短視頻制作：用戶自制的短視頻，使用人臉美妝技術，提升觀看效果。
  • 相機等APP：用于相機和其他視頻類APP中，提升視覺美感，增加趣味性。

特色優勢

  • 效果自然：適用不同表情、性別、年齡和姿態，美妝美顏效果處理自然，打造無暇妝容。
  • 精準度高：實現照片人臉定位，妝容與面部五官的貼合度高。
  • 不同類型：可選擇不同類型的美妝類型，搭配個性化美妝素材，完成妝容。
  • 彩妝效果：通過添加口紅、高光、眼影、整妝等素材，進一步提升人臉美化效果。

接入指引

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

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

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

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

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

5. 開發接入步驟：

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

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

輸入限制

  • 圖像格式：PNG、JPG、JPEG、BMP、TIFF、WEBP。
  • 圖像大小：不超過3 MB。
  • 圖像分辨率：最大分辨率不超過2000×2000像素，最長邊小于2000像素，建議為1080×1920像素。
  • URL地址中不能包含中文字符。
  • 圖像質量建議：對于光線充足且均勻條件下的大部分膚質人像圖像效果較佳，不適用于包含比較嚴重色斑、痤瘡或低曝等場景的圖像。

計費說明

關于人臉美妝的計費方式及報價，請參見計費介紹。

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

調試

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

請求參數

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

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

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

輸入限制：

  • 圖像格式：PNG、JPG、JPEG、BMP、TIFF、WEBP。
  • 圖像大小：不超過4 MB。
  • 圖像分辨率：最大分辨率不超過2000×2000像素，最長邊小于2000像素，建議為1080×1920像素。
  • URL地址中不能包含中文字符。
  • 圖像質量建議：對于光線充足且均勻條件下的大部分膚質人像圖像效果較佳，不適用于包含比較嚴重色斑、痤瘡或低曝等場景的圖像。
MakeupType String 是 whole

美妝類型，當前支持whole（整妝）。
ResourceType String 是 0

美妝使用的風格，具體包括：0（whole）、1（基礎妝）、2（少女妝）、3（活力妝）、4（優雅妝）、5（魅惑妝）、6（梅子妝）。
Strength Float 是 1

美妝強度，取值范圍0～1。

返回數據

名稱 類型 示例值 描述
RequestId String AAECB606-E752-4CEA-8EA5-6EBE942A7663

請求ID。
Data Object

返回的結果數據內容。
ImageURL String http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-makeup/2020_03_24/c0f815f46b3df61e_facebeauty.jpg?Expires=1585279130&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=1QkDpev9B7ybzup1MN%2F72kzrKL****

人臉美妝結果圖像的URL地址。

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

SDK參考

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

示例

請求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=FaceMakeup      //更多關于訪問域名（Endpoint）信息，請參見：http://m.bestwisewords.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/FaceMakeup/FaceMakeup8.png
&MakeupType=whole
&ResourceType=0
&Strength=1
&<公共請求參數>

正常返回示例

XML格式

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

<RequestId>AAECB606-E752-4CEA-8EA5-6EBE942A7663</RequestId>
<Data>
    <ImageURL>http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-makeup/2020_03_24/c0f815f46b3df61e_facebeauty.jpg?Expires=1585279130&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=1QkDpev9B7ybzup1MN%2F72kzrKL****</ImageURL>
</Data>

JSON格式

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

{
  "RequestId" : "AAECB606-E752-4CEA-8EA5-6EBE942A7663",
  "Data" : {
    "ImageURL" : "http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-makeup/2020_03_24/c0f815f46b3df61e_facebeauty.jpg?Expires=1585279130&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=1QkDpev9B7ybzup1MN%2F72kzrKL****"
  }
}

錯誤碼

關于人臉美妝的錯誤碼，詳情請參見常見錯誤碼。

開源模型體驗

更多開源免費模型體驗及下載，詳見魔搭社區：106點人臉關鍵點-通用領域-2D。

安全聲明

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