本文介紹視頻生產(videoenhan)類目下的通用視頻人臉融合MergeVideoFace的語法及示例。
功能描述
在獲得用戶授權的前提下,通用視頻人臉融合能力可以將視頻中檢測到的最大人臉,融合進另一個人的人臉特征,達到換臉的感官效果。
通用視頻人臉融合只需要輸入一張帶融合人臉圖像與一段視頻,就可以將圖像人臉融合進視頻中。
適用場景:
- 每次合成獨立完成,無通用模板場景。
- 僅支持視頻中只有一張人臉的場景。
如需使用多人場景或有固定數量的視頻模板,請參見模板視頻人臉融合(MergeVideoModelFace)。
為保證生成內容的安全合法,請勿使用公眾人物或涉及敏感信息的圖像或視頻進行融合,同時,本服務也會在合成結果的左下角處添加Generated by AI的水印內容,效果如下圖所示。
應用場景
- 影視后期制作:在影視后期制作時,因為某些原因需要替換演員,通過視頻人臉融合技術,可利用前期拍攝素材進行處理,讓前期視頻素材中的人物看起來是新的演員在表演,可以為制片方節省大量的重新拍攝成本。
- 娛樂性短視頻制作:用戶可以將已獲授權的合法視頻中的人物,換成自己的人臉,生成趣味性視頻。
特色優勢
- 高保真、低違和效果:融合后的人臉保留了替換者人臉身份信息的視覺特征,而融入被替換者人臉中又無違和感。
- 表情膚色一致性:融合后的人臉最大限度保留被替換者的面目表情、膚色一致性。
- 支持復雜人臉角度:支持模板人臉偏側一定角度,融合后的結果真實穩定。
接入指引
1. 注冊阿里云賬號:打開阿里云官網,在阿里云官網右上角,單擊立即注冊,按照操作提示完成賬號注冊。
2. 開通能力:請確保您已開通視頻生產服務,若未開通服務請立即開通。
2024年7月17日之前開通該服務的用戶如需調用,可通過釘釘群(23109592)加入阿里云視覺智能開放平臺咨詢群聯系我們添加到白名單。
3. 創建AccessKey:請確保您已創建AccessKey,如果您使用的是子賬號AccessKey,您需要給子賬號賦予AliyunVIAPIFullAccess權限,具體操作,請參見RAM授權。
4. 在線調試(可選):您可以通過OpenAPI Explorer在線調試能力,查看完整的調用示例代碼及SDK依賴信息,也可以下載完整的工程。
5. 開發接入步驟:
- 在SDK總覽中選擇您要接入使用的SDK語言。
- 在對應語言的SDK文檔中找到AI類目為視頻生產(videoenhan)類目的SDK包進行安裝。
- 參考文檔中提供的示例代碼進行適當修改后調用。
6. 示例代碼:該能力常用語言的示例代碼,請參見視頻人臉融合示例代碼,常用語言查詢異步任務結果的示例代碼,請參見查詢異步任務結果示例代碼。
7. 客戶端直接調用:該能力常用的客戶端調用方式包括以下幾種。
輸入限制
- 視頻類型:MP4、AVI、MKV、MOV、FLV、TS、MPG。
- 視頻分辨率:大于360×360像素,小于1920×1920像素。
- 視頻大小:不大于120 MB。
- 圖像格式:JPEG、JPG、PNG。
- 圖像分辨率:大于等于128×128像素,小于等于4000×4000像素。
- 圖像大小:不大于20 MB。
- URL地址不能包含中文字符。
- 視頻只支持靜態(恒定)幀率視頻,暫不支持動態(可變)幀率視頻。
- 視頻時長不大于300s,大于300s的視頻請調用模板視頻人臉融合接口。
圖像質量建議
- 要求保證圖像中的人臉清晰。圖像中人臉尺寸建議大于64×64像素,人臉區域建議不大于全圖區域的2/3。
- 建議圖像中人臉五官區域輪廓完整,無明顯遮擋。人臉融合算法支持人臉偏側一定角度,在偏側角度不超過30度的情況下能取得更佳效果。
- 建議待融合人臉的圖像中只包含一張人臉,如果包含多張人臉,則默認選擇圖像中最大的人臉進行融合。
推薦圖像示例:
不推薦圖像示例:
調用步驟
該能力為異步能力,需分兩步進行調用。
第一步調用MergeVideoFace接口提交任務,請求成功后,得到一個任務ID。
第二步調用GetAsyncJobResult接口查詢結果,根據任務ID查詢任務執行狀態和結果。如果任務還在處理中,可稍等一段時間后再進行查詢。
計費說明
關于通用視頻人臉融合的計費方式及報價,請參見計費介紹。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | MergeVideoFace | 系統規定參數。取值:MergeVideoFace。 |
VideoURL | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/videoenhan/MergeVideoFace/MergeVideoFace1.mp4 | 輸入視頻的URL地址。推薦使用上海地域的OSS鏈接,對于文件在本地或者非上海地域OSS鏈接的情況,請參見文件URL處理。 |
ReferenceURL | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/videoenhan/MergeVideoFace/MergeVideoFace-pic1.png | 替換后的人臉參考圖像URL地址。推薦使用上海地域的OSS鏈接,對于文件在本地或者非上海地域OSS鏈接的情況,請參見文件URL處理。 輸入限制:
|
AddWatermark | Boolean | 否 | True | 是否添加水印。取值范圍如下:
|
Enhance | Boolean | 否 | False | 是否開啟人臉美顏增強。取值范圍如下:
|
WatermarkType | String | 否 | EN | 水印類型。取值范圍如下:
|
返回數據
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | DEF90E76-B62D-45EF-8835-CA3C83842B18 | 請求ID。 |
Data | Object | 返回的結果數據內容。 該數據需要在異步任務執行成功后,通過調用GetAsyncJobResult接口,對其Result字段進行JSON反序列化之后得到。 |
|
VideoURL | String | http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/A657011C-82B4-4705-A5DB-69B18B7CE89D.mp4?Expires=1606378308&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=Hl3cq5XedTGCscOSr0OGVxAS2o**** | 處理后的視頻URL地址。 說明 該URL地址為臨時地址,有效期為30分鐘,過期后將無法訪問。若需要長時間或者永久保存文件,請在30分鐘內訪問URL地址,下載文件轉存到自己的OSS或者其他存儲空間。 |
Message | String | 該調用為異步調用,任務已提交成功,請以requestId的值作為jobId參數調用同類目下GetAsyncJobResult接口查詢任務執行狀態和結果。 | 提交異步任務后的提示信息。 |
查詢結果
該接口為異步接口,當前并未返回真實的請求結果,您需要通過返回的RequestId調用GetAsyncJobResult接口來獲取該接口的真實請求結果。詳情請參見GetAsyncJobResult。
SDK參考
阿里云視覺AI視頻生產類目下的通用視頻人臉融合能力推薦使用SDK調用,支持多種編程語言,調用時請選擇AI類目為視頻生產(videoenhan)的SDK包,文件參數通過SDK調用可支持本地文件及任意URL,具體可參見SDK總覽。
示例代碼
該能力常用語言的示例代碼,請參見通用視頻人臉融合示例代碼,常用語言查詢異步任務結果的示例代碼,請參見查詢異步任務結果示例代碼。
示例
請求示例
http(s)://videoenhan.cn-shanghai.aliyuncs.com/?Action=MergeVideoFace //更多關于訪問域名(Endpoint)信息,請參見:http://bestwisewords.com/document_detail/143103.html
&VideoURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/videoenhan/MergeVideoFace/MergeVideoFace1.mp4
&ReferenceURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/videoenhan/MergeVideoFace/MergeVideoFace-pic1.png
&AddWatermark=true
&Enhance=false
&WatermarkType=EN
&公共請求參數
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<MergeVideoFaceResponse>
<RequestId>DEF90E76-B62D-45EF-8835-CA3C83842B18</RequestId>
<Data>
<VideoURL>http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/A657011C-82B4-4705-A5DB-69B18B7CE89D.mp4?Expires=1606378308&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=Hl3cq5XedTGCscOSr0OGVxAS2o****</VideoURL>
</Data>
<Message>該調用為異步調用,任務已提交成功,請以requestId的值作為jobId參數調用同類目下GetAsyncJobResult接口查詢任務執行狀態和結果。</Message>
</MergeVideoFaceResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "DEF90E76-B62D-45EF-8835-CA3C83842B18",
"Message" : "該調用為異步調用,任務已提交成功,請以requestId的值作為jobId參數調用同類目下GetAsyncJobResult接口查詢任務執行狀態和結果。"
}
返回示例補充說明
//查詢結果:請求示例
http(s)://videoenhan.cn-shanghai.aliyuncs.com/?Action=GetAsyncJobResult
&JobId=E75FE679-0303-4DD1-8252-1143B4FA8A27
&<公共請求參數>
//查詢結果:返回示例
{
"RequestId" : "43A0AEB6-45F4-4138-8E89-E1A5D63200E3",
"Data" : {
"Status" : "PROCESS_SUCCESS",
"JobId" : "186AC396-0EEC-46F1-AAA1-BF3585227427",
"Result" : "{\"VideoURL\":\"http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/A657011C-82B4-4705-A5DB-69B18B7CE89D.mp4?Expires=1606378308&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=Hl3cq5XedTGCscOSr0OGVxAS2o****\"}"
}
}
//Result反序列化
{
"VideoURL" : "http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/video-face-fusion/A657011C-82B4-4705-A5DB-69B18B7CE89D.mp4?Expires=1606378308&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=Hl3cq5XedTGCscOSr0OGVxAS2o****"
}
錯誤碼
關于視頻人臉融合的錯誤碼,詳情請參見常見錯誤碼。
安全聲明
- 請確保上傳的圖片或文件來源符合相應的法律法規。
- 通過體驗調試上傳的臨時文件有效期為1小時,在24小時后會被系統自動清理刪除。