本文介紹人臉人體（facebody）類目下的人臉美型FaceTidyup的語法及示例。
功能描述
人臉美型能力可以對人臉的輪廓和五官進行調整。 您也可以通過手動調整美型強度，進一步對人臉進行精細化調整。
關于該接口功能的示例圖如下：
- 輸入原圖
- 大眼
- 瘦鼻
- 瘦臉
- 瘦下巴
- 嘴型
當前支持的精細調整如下。
臉型 |
眼睛 |
鼻子 |
嘴型 |
其他 |
削臉 |
大眼 |
瘦鼻 |
唇寬 |
顴骨 |
瘦臉 |
眼距 |
鼻翼 |
唇高 |
下頜 |
臉長 |
眼角 |
鼻長 |
大小 |
人中 |
無 |
眼高 |
鼻頭 |
無 |
下巴 |
應用場景
- 美顏相機：對拍攝的照片進行大眼、瘦臉、瘦下巴、嘴型、瘦鼻等效果處理，提升人物的社交形象。
- 直播短視頻：在直播間的主播們，通過人臉美型技術，讓自己更有吸引力，有更多粉絲關注。
- 短視頻制作：用戶自制的短視頻，使用人臉美型技術，提升觀看效果。
- 相機等APP：用于相機和其他視頻類APP中，提升視覺美感，增加趣味性。
特色優勢
- 支持多種美型：支持大眼、瘦臉、瘦下巴、嘴型、瘦鼻等多種效果。
- 自定義調整：支持自定義調整參數，幫助提升個人形象。
接入指引
1. 注冊阿里云賬號：打開阿里云官網，在阿里云官網右上角，單擊立即注冊，按照操作提示完成賬號注冊。
2. 開通能力：請確保您已開通人臉人體服務，若未開通服務請立即開通。
3. 創建AccessKey：請確保您已創建AccessKey，如果您使用的是子賬號AccessKey，您需要給子賬號賦予AliyunVIAPIFullAccess權限，具體操作，請參見RAM授權。
4. 在線調試（可選）：您可以通過OpenAPI Explorer在線調試能力，查看完整的調用示例代碼及SDK依賴信息，也可以下載完整的工程。
5. 開發接入步驟：
- 在SDK總覽中選擇您要接入使用的SDK語言。
- 在對應語言的SDK文檔中找到AI類目為人臉人體（facebody）的SDK包進行安裝。
- 參考文檔中提供的示例代碼進行適當修改后調用。
6. 客戶端直接調用：該能力常用的客戶端調用方式包括以下幾種。
輸入限制
- 圖像格式：JPEG、JPG、PNG、BMP。
- 圖像大小：不超過3 MB。
- 圖像分辨率：分辨率大于10×10像素，分辨率小于2000x2000像素，最長邊小于2000像素。
- URL地址中不能包含中文字符。
-
圖像質量建議：輸入圖像盡量保持光線充足且均勻，人臉完整較少遮擋，角度[raw, yaw, pitch]小于60度為佳。
說明 當圖像分辨率超過最大限制時，請先將圖片進行縮放，調整圖片大小，具體請參見圖片縮放。
計費說明
人臉美型能力目前處于公測期，可免費調用。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
|
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
| Action | String | 是 | FaceTidyup | 系統規定參數。取值：FaceTidyup。 |
| ImageURL | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/FaceTidyup/FaceTidyup5.png | 圖像URL地址。推薦使用上海地域的OSS鏈接，對于文件在本地或者非上海地域OSS鏈接的情況，請參見文件URL處理。 輸入限制：
|
| ShapeType | Integer | 是 | 0 | 表示美型部位，包括：0（顴骨）、1（削臉）、2（瘦臉）、3（臉長）、4（下巴縮短）、5（下巴拉長）、6（瘦下巴）、7（瘦下頜）、8（大眼）、9（眼角1）、10（眼距）、11（拉寬眼距）、12（眼角2）、13（眼睛高度）、14（瘦鼻）、15（鼻翼）、16（鼻長）、17（鼻頭長）、18（唇寬）、19（嘴唇大小）、20（唇高）、21（人中）。 |
| Strength | Float | 是 | 1 | 美型強度，取值范圍0~1。 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
| RequestId | String | 8F3BF64D-4FDF-4AAF-9B34-11B4EF4CE815 | 請求ID。 |
| Data | Object | 返回的數據內容。 |
|
| ImageURL | String | http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-shape/2020_03_24/7cb93b25ac5cbbb4_facetidy.jpg?Expires=1585280344&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=RIPIlTZ2GNmdLyACGWz6wUzJxN**** | 人臉美型結果圖片URL地址。 說明 該URL地址為臨時地址，有效期為30分鐘，過期后將無法訪問。若需要長時間或者永久保存文件，請在30分鐘內訪問URL地址，下載文件轉存到自己的OSS或者其他存儲空間。 |
SDK參考
阿里云視覺AI人臉人體類目下的人臉美型能力推薦使用SDK調用，支持多種編程語言，調用時請選擇AI類目為人臉人體（facebody）的SDK包，文件參數通過SDK調用可支持本地文件及任意URL，具體可參見SDK總覽。
示例
請求示例
http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=FaceTidyup //更多關于訪問域名（Endpoint）信息，請參見：http://bestwisewords.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/FaceTidyup/FaceTidyup5.png
&ShapeType=0
&Strength=1
&<公共請求參數>正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RequestId>8F3BF64D-4FDF-4AAF-9B34-11B4EF4CE815</RequestId>
<Data>
<ImageURL>http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-shape/2020_03_24/7cb93b25ac5cbbb4_facetidy.jpg?Expires=1585280344&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=RIPIlTZ2GNmdLyACGWz6wUzJxN****</ImageURL>
</Data>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "8F3BF64D-4FDF-4AAF-9B34-11B4EF4CE815",
"Data" : {
"ImageURL" : "http://algo-app-taobao-mm-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/pixelai-portrait-shape/2020_03_24/7cb93b25ac5cbbb4_facetidy.jpg?Expires=1585280344&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=RIPIlTZ2GNmdLyACGWz6wUzJxN****"
}
}錯誤碼
關于人臉美型的錯誤碼，詳情請參見常見錯誤碼。
開源模型體驗
更多開源免費模型體驗及下載，詳見魔搭社區：106點人臉關鍵點-通用領域-2D。
安全聲明
- 請確保上傳的圖片或文件來源符合相應的法律法規。
- 通過體驗調試上傳的臨時文件有效期為1小時，在24小時后會被系統自動清理刪除。