本文介绍图像人脸融合MergeImageFace的语法及示例。

功能描述

图像人脸融合功能可以帮助用户在获得授权的前提下,将图像中的指定的某个人脸,融合进另一人的人脸特征。

应用场景

娱乐应用:用户将已获授权的合法图像中的人物,换成自己的人脸。

特色优势

  • 适合各种人脸姿态:通过对人脸3D特征的高精度提取,可以适应人脸偏侧一定角度内的人脸融合。
  • 高保真、低违和效果:融合后的人脸保留了替换者人脸身份信息的视觉特征,而融入被替换者人脸中又无违和感。
  • 表情保留:融合后的人脸最大限度保留被替换者的面目表情。

前提条件

  • 请确保您已开通人脸人体服务,若未开通服务请立即开通
  • 开通服务后请提交申请,申请通过后方可使用。
  • 已通过图像人脸融合模板增加(AddFaceImageTemplate)创建并生成了UserId和TemplateId。
说明 本能力仅限企业认证用户开通。更多实名认证操作信息,请参见实名认证

输入限制

  • 图像格式:JPG、JPEG、PNG。
  • 图像大小:不超过20 MB。
  • 图像分辨率:大于128×128像素,小于2000×2000像素。人脸尺寸建议大于64×64像素。
  • URL地址中不能包含中文字符。
说明 当图像分辨率超过最大限制时,请先将图片进行缩放,调整图片大小,具体请参见图片缩放

计费说明

关于图像人脸融合的计费方式及报价,请参见计费介绍

说明 下方调试接口为付费接口,如需免费体验调试请前往体验中心

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String MergeImageFace

系统规定参数。取值:MergeImageFace

UserId String zhangsan

人脸模板的用户ID。

说明
  • 当不输入值时,系统获取登录账号的对应UID作为默认用户ID。
  • 当输入值时,请输入通过图像人脸融合模板增加(AddFaceImageTemplate)创建的UserId
TemplateId String 6cd509ea-54fa-4730-8e9d-c94cadcda048

人脸模板的模板ID。

ImageURL String http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png

待融合的人脸照片。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

返回数据

名称 类型 示例值 描述
RequestId String 8473A5E5-488E-4612-800E-F95B42381570

请求ID。

Data Object

返回的结果数据内容。

ImageURL String http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/image-face-fusion/09dedc78-c355-442a-9312-7ab074d6de49_54dc_20210129-025407.jpg?Expires=1611890647&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=2mk2OgIrwMqrvA%2FvDdp0MNaoVU****

融合后的图像URL地址。

说明 该URL地址为临时地址,有效期为30分钟,过期后将无法访问。

示例

请求示例

http(s)://[Endpoint]/?Action=MergeImageFace
&UserId=zhangsan
&TemplateId=6cd509ea-54fa-4730-8e9d-c94cadcda048
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png
&公共请求参数

正常返回示例

XML格式

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

<RequestId>8473A5E5-488E-4612-800E-F95B42381570</RequestId>
<Data>
    <ImageURL>http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/image-face-fusion/09dedc78-c355-442a-9312-7ab074d6de49_54dc_20210129-025407.jpg?Expires=1611890647&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=2mk2OgIrwMqrvA%2FvDdp0MNaoVU****</ImageURL>
</Data>

JSON格式

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

{
  "RequestId" : "8473A5E5-488E-4612-800E-F95B42381570",
  "Data" : {
    "ImageURL" : "http://vibktprfx-prod-prod-aic-gd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/image-face-fusion/09dedc78-c355-442a-9312-7ab074d6de49_54dc_20210129-025407.jpg?Expires=1611890647&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=2mk2OgIrwMqrvA%2FvDdp0MNaoVU****"
  }
}

错误码

关于图像人脸融合的错误码,详情请参见常见错误码

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。