功能描述

圖像人臉融合模板增加功能可以將已通過(guò)內(nèi)容審核的人臉圖像，作為人臉融合的模板圖，供圖像人臉融合功能使用。

接入指引

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

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

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

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

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

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

6. 示例代碼：該能力常用語(yǔ)言的示例代碼，請(qǐng)參見(jiàn)圖像人臉融合模板增加示例代碼。

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

• Web前端直接調(diào)用
• 小程序場(chǎng)景下直接調(diào)用
• Android端直接調(diào)用
• iOS端直接調(diào)用

輸入限制

• 圖像格式：JPG、JPEG、PNG。
• 圖像大?。翰怀^(guò)20 MB。
• 圖像分辨率：大于等于128×128像素，小于等于2000×2000像素，最長(zhǎng)邊小于等于2000像素。
• URL地址中不能包含中文字符。
• 支持輸入多人圖像，建議圖像中人臉個(gè)數(shù)不超過(guò)5個(gè)。
• 不限制可以增加的模板數(shù)量。

圖像質(zhì)量建議

• 要求保證圖像中的人臉清晰。圖像中人臉尺寸建議大于64×64像素，人臉區(qū)域建議不大于全圖區(qū)域的2/3。
• 建議圖像中人臉五官區(qū)域輪廓完整，無(wú)明顯遮擋。人臉融合算法支持人臉偏側(cè)一定角度，在偏側(cè)角度不超過(guò)30度的情況下能取得更佳效果。

推薦圖像示例：

不推薦圖像示例：

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

圖像人臉融合模板增加能力可免費(fèi)調(diào)用。

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

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

SDK參考

阿里云視覺(jué)AI人臉人體類(lèi)目下的圖像人臉融合模板增加能力推薦使用SDK調(diào)用，支持多種編程語(yǔ)言，調(diào)用時(shí)請(qǐng)選擇AI類(lèi)目為人臉人體（facebody）的SDK包，文件參數(shù)通過(guò)SDK調(diào)用可支持本地文件及任意URL，具體可參見(jiàn)SDK總覽。

示例代碼

該能力常用語(yǔ)言的示例代碼，請(qǐng)參見(jiàn)圖像人臉融合模板增加示例代碼。

示例

請(qǐng)求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=AddFaceImageTemplate   //更多關(guān)于訪問(wèn)域名（Endpoint）信息，請(qǐng)參見(jiàn)：http://bestwisewords.com/document_detail/143103.html
&ImageURL=https://invi-label.oss-cn-shanghai.aliyuncs.com/label/temp/faceswap/img_facefusion/template/sucai1.jpg
&公共請(qǐng)求參數(shù)

請(qǐng)求示例補(bǔ)充說(shuō)明

//當(dāng)輸入的人臉模板為多人臉場(chǎng)景時(shí)，請(qǐng)求示例如下：
http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=AddFaceImageTemplate   //更多關(guān)于訪問(wèn)域名（Endpoint）信息，請(qǐng)參見(jiàn)：http://bestwisewords.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectPedestrian/DetectPedestrian8.jpg
&公共請(qǐng)求參數(shù)

正常返回示例

XML格式

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

<AddFaceImageTemplateResponse>
    <RequestId>7BC58484-6724-508F-857D-0E7035AD5DEA</RequestId>
    <Data>
        <TemplateId>30f738a9-1e69-4ecb-8bbc-50bf0aa75e60</TemplateId>
    </Data>
</AddFaceImageTemplateResponse>

JSON格式

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

{
  "RequestId" : "7BC58484-6724-508F-857D-0E7035AD5DEA",
  "Data" : {
    "TemplateId" : "30f738a9-1e69-4ecb-8bbc-50bf0aa75e60"
  }
}

返回示例補(bǔ)充說(shuō)明

//當(dāng)輸入的人臉模板為多人臉場(chǎng)景時(shí)，返回示例如下：
{
  "RequestId": "0AE75311-21D6-5E7A-AF6D-70956E67ED89",
  "Data": {
    "FaceInfos": [
      {
        "FaceRect": {
          "X": "421.4748",
          "Y": "91.21092",
          "Height": "109.89087",
          "Width": "102.43414"
        },
        "TemplateFaceID": "b44fe21c-5c81-41f3-93c5-8177b895b7cf_0"
      },
      {
        "FaceRect": {
          "X": "181.38963",
          "Y": "139.80676",
          "Height": "98.78714",
          "Width": "97.7758"
        },
        "TemplateFaceID": "b44fe21c-5c81-41f3-93c5-8177b895b7cf_1"
      },
      {
        "FaceRect": {
          "X": "655.54626",
          "Y": "144.6498",
          "Height": "94.08194",
          "Width": "99.913025"
        },
        "TemplateFaceID": "b44fe21c-5c81-41f3-93c5-8177b895b7cf_2"
      }
    ],
    "TemplateId": "b44fe21c-5c81-41f3-93c5-8177b895b7cf"
  }
}

錯(cuò)誤碼

關(guān)于圖像人臉融合模板增加的錯(cuò)誤碼，詳情請(qǐng)參見(jiàn)常見(jiàn)錯(cuò)誤碼。

安全聲明

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