功能描述

人物動漫化能力可以將一張人物圖像進行轉換處理，生成卡通形象，并返回動漫化后的結果圖像。

• 支持風格：國畫（NEW）、港漫（NEW）、漫畫風（NEW）、動畫3D（NEW）、日漫、3D、手繪、鉛筆畫和藝術特效9個風格。
• 多人照片：可轉換多人照片，一次可處理圖片中最多5個人臉。

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

• 漫畫風（NEW）：漫畫風格模擬復古漫畫風格中的人物形象，適合各種類型的寫真照片。
• 動畫3D風（NEW）：動畫3D風格模擬動畫3D的人物形象和質感，適合各種類型的寫真照片。
• 港漫風（NEW）：港漫風格的能力比較綜合，適合各種類型的照片。
• 國畫風（NEW）：國畫風格適合古裝寫真照，如漢服、唐裝等，以全身照和半身照背景簡約的照片為宜。
• 手繪風：手繪風格適合各種類型的寫真照片。
• 藝術特效：藝術特效適合照片顏色比較鮮艷，彩妝、濃妝等寫真造型。
• 3D特效：3D特效風格比較綜合，適合各種類型的人物照片。
• 日漫風：日漫風格比較綜合，適合各種類型的人物照片，以Cosplay類型為佳。
• 鉛筆畫：鉛筆畫風格比較綜合，適合各種類型的人物照片。

應用場景

• 保護隱私：為保護圖像中的人物隱私，將人物卡通化，可避免識別出原人物是誰。保留社交趣味度的同時避免過度娛樂化。
• 社交娛樂：將自己的照片變成卡通人物，塑造可愛氛圍，配上圖文分享給朋友。
• 特效應用：可用于打造個性頭像以及趣味活動等場景。

特色優勢

• 復刻人物表情：基于深度學習算法，識別人物性別、表情等特征，在卡通頭像上還原。
• 全身卡通化：相比人臉卡通化，可避免笑場等尷尬場景。
• 多人模式：可處理情侶照、家庭照、團體類照片。

接入指引

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

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

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

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

5. 開發接入步驟：

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

6. 示例代碼：該能力常用語言的示例代碼，請參見人物動漫化示例代碼。

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

• Web前端直接調用
• 小程序場景下直接調用
• Android端直接調用
• iOS端直接調用

輸入限制

• 圖像格式：JPG、JPEG、PNG。
• 圖像大小：不超過3 MB。
• 圖像分辨率：大于32×32像素，小于2000×2000像素，最長邊小于等于1999像素，人臉占比不低于60×60像素。
• 支持有單人或多人的人臉清晰正面照，最大人臉數目限制5，人臉朝向在上下左右45度以內。
• URL地址中不能包含中文字符。

計費說明

關于人物動漫化的計費方式及報價，請參見計費介紹。

請求參數

返回數據

SDK參考

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

示例代碼

該能力常用語言的示例代碼，請參見人物動漫化示例代碼。

示例

請求示例

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

正常返回示例

XML格式

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

<GenerateHumanAnimeStyleResponse>
    <RequestId>59697D68-2A6E-4553-89BD-0FADD07881E8</RequestId>
    <Data>
        <ImageURL>https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/viapi-video/person_image_cartoonizer/2023-10-25/55798d04-0957-4ab1-accc-0e4d2d01a039/20231025092636774205_styleanime_n2vedxruht.jpg?Expires=1698283596&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSR****&amp;Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****</ImageURL>
    </Data>
</GenerateHumanAnimeStyleResponse>

JSON格式

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

{
  "RequestId" : "59697D68-2A6E-4553-89BD-0FADD07881E8",
  "Data" : {
    "ImageURL" : "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/viapi-video/person_image_cartoonizer/2023-10-25/55798d04-0957-4ab1-accc-0e4d2d01a039/20231025092636774205_styleanime_n2vedxruht.jpg?Expires=1698283596&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSR****&Signature=ut2kn46Lz%2FRwqJ9jWJ0RBDut12****"
  }
}

錯誤碼

關于人物動漫化的錯誤碼，詳情請參見常見錯誤碼。

安全聲明

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