本文介紹添加人臉人體（facebody）類目下的人像素描風(fēng)格化GenerateHumanSketchStyle的語(yǔ)法及示例。

功能描述

人像素描風(fēng)格化能力可以對(duì)一張人物圖像自動(dòng)識(shí)別其頭部區(qū)域，生成大頭照下的素描畫效果。返回結(jié)果的分辨率固定為512x512像素。

關(guān)于該接口功能的示例圖如下：

  • 輸入原圖輸入圖像
  • 輸出效果圖生成效果
說(shuō)明
  • 您可以進(jìn)入在線咨詢獲取在線人工幫助。
  • 當(dāng)前能力可在視覺(jué)智能開放平臺(tái)有完整的免費(fèi)產(chǎn)品體驗(yàn)，您可以單擊立即試用對(duì)該能力進(jìn)行更直觀試用以及在線購(gòu)買。
  • 阿里云視覺(jué)智能開放平臺(tái)視覺(jué)AI能力API接入、接口使用或問(wèn)題咨詢等，請(qǐng)通過(guò)釘釘群（23109592）加入阿里云視覺(jué)智能開放平臺(tái)咨詢?nèi)郝?lián)系我們。

應(yīng)用場(chǎng)景

社交娛樂(lè)：輸入一張個(gè)人照片，通過(guò)人像素描風(fēng)格化算法能力，會(huì)生成一張獨(dú)一無(wú)二的素描肖像畫。可以與朋友分享，也可以用來(lái)做頭像。

特色優(yōu)勢(shì)

精準(zhǔn)刻畫：通過(guò)深度學(xué)習(xí)算法，精準(zhǔn)還原人臉五官特征，連發(fā)絲都可精準(zhǔn)還原。

接入指引

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

2. 開通能力：請(qǐng)確保您已開通人臉人體服務(wù)，若未開通服務(wù)請(qǐng)立即開通。

說(shuō)明 本能力支持企業(yè)或個(gè)人認(rèn)證用戶開通。更多實(shí)名認(rèn)證操作信息，請(qǐng)參見實(shí)名認(rèn)證。

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

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

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

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

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

輸入限制

  • 圖像格式：JPG、JPEG、PNG。
  • 圖像大小：小于10 MB。
  • 圖像分辨率：大于100×100像素，小于2000×2000像素，最長(zhǎng)邊小于等于1999像素；人臉占比不低于60×60像素。
  • 圖像質(zhì)量：支持有單人人臉的清晰正面照，人臉朝向在上下左右45度以內(nèi)。
  • URL地址中不能包含中文字符。
說(shuō)明 當(dāng)圖像分辨率超過(guò)最大限制時(shí)，請(qǐng)先將圖片進(jìn)行縮放，調(diào)整圖片大小，具體請(qǐng)參見圖片縮放。

計(jì)費(fèi)說(shuō)明

關(guān)于人像素描風(fēng)格化的計(jì)費(fèi)方式及報(bào)價(jià)，請(qǐng)參見計(jì)費(fèi)介紹。

調(diào)試

您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。

請(qǐng)求參數(shù)

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

系統(tǒng)規(guī)定參數(shù)。取值：GenerateHumanSketchStyle。
ImageURL String 是 http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/GenerateHumanSketchStyle/GenerateHumanSketchStyle7.png

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

圖片格式要求：

  • 圖像格式：JPG、JPEG、PNG。
  • 圖像大小：小于10 MB。
  • 圖像分辨率：大于100×100像素，小于2000×2000像素，最長(zhǎng)邊小于等于1999像素；人臉占比不低于60×60像素。
  • 圖像質(zhì)量：支持有單人人臉的清晰正面照，人臉朝向在上下左右45度以內(nèi)。
  • URL地址中不能包含中文字符。
    說(shuō)明 圖像內(nèi)容：當(dāng)圖像分辨率超過(guò)最大限制時(shí)，請(qǐng)先將圖片進(jìn)行縮放，調(diào)整圖片大小，具體請(qǐng)參見圖片縮放。
ReturnType String 否 head

圖像返回形式。取值如下：

  • head：大頭照（默認(rèn)）
  • full：全身照

推薦使用大頭照，處理效果更佳。

返回?cái)?shù)據(jù)

名稱 類型 示例值 描述
RequestId String E499788C-22DA-4F0E-B9C0-0E9D30A25716

請(qǐng)求ID。
Data Object

返回的結(jié)果數(shù)據(jù)內(nèi)容。
ImageURL String http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/person-image-pencil/fd49dd0a-9e24-4bb5-b303-0745cdb453e0_7aa6_20210128-073045.jpg?Expires=1611820849&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=1oLYG%2FPe%2BNRIK7XcsUQYaKF%2B1C****

返回圖片URL地址。

說(shuō)明 該URL地址為臨時(shí)地址，有效期為30分鐘，過(guò)期后將無(wú)法訪問(wèn)。

SDK參考

阿里云視覺(jué)AI人臉人體類目下的人像素描風(fēng)格化能力推薦使用SDK調(diào)用，支持多種編程語(yǔ)言，調(diào)用時(shí)請(qǐng)選擇AI類目為人臉人體（facebody）的SDK包，文件參數(shù)通過(guò)SDK調(diào)用可支持本地文件及任意URL，具體可參見SDK總覽。

示例

請(qǐng)求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=GenerateHumanSketchStyle      //更多關(guān)于訪問(wèn)域名（Endpoint）信息，請(qǐng)參見：http://bestwisewords.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/GenerateHumanSketchStyle/GenerateHumanSketchStyle7.png
&ReturnType=head
&公共請(qǐng)求參數(shù)

正常返回示例

XML格式

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

<GenerateHumanSketchStyleResponse>
    <RequestId>E499788C-22DA-4F0E-B9C0-0E9D30A25716</RequestId>
    <Data>
        <ImageURL>http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/person-image-pencil/fd49dd0a-9e24-4bb5-b303-0745cdb453e0_7aa6_20210128-073045.jpg?Expires=1611820849&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=1oLYG%2FPe%2BNRIK7XcsUQYaKF%2B1C****</ImageURL>
    </Data>
</GenerateHumanSketchStyleResponse>

JSON格式

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

{
  "RequestId" : "E499788C-22DA-4F0E-B9C0-0E9D30A25716",
  "Data" : {
    "ImageURL" : "http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/person-image-pencil/fd49dd0a-9e24-4bb5-b303-0745cdb453e0_7aa6_20210128-073045.jpg?Expires=1611820849&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=1oLYG%2FPe%2BNRIK7XcsUQYaKF%2B1C****"
  }
}

錯(cuò)誤碼

關(guān)于人像素描風(fēng)格化的錯(cuò)誤碼，詳情請(qǐng)參見常見錯(cuò)誤碼。

安全聲明

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