MergeImageFace
图像人脸融合MergeImageFace的语法及示例
服务地址:
华东2(上海)
输入参数
只看必填
TemplateId人脸模板的模板ID
ImageURL待融合的人脸照片
ModelVersion提供两版模型
AddWatermark是否添加水印
请选择布尔值
WatermarkType水印类型
MergeInfos
0仅在模板图为多人场景下使用
TemplateFaceID多脸模板对应的某个人脸的子ID
ImageURL该人脸待替换的图像URL
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

功能描述

图像人脸融合功能可以将用户图中的人脸融合到模板图中的人脸位置,生成一张包含用户图人脸特征的新图像。特别注意的是,该功能严格要求使用者事先获得用户图和模版图的授权,不得用于非法或有违道德约束的场景中。 关于该接口功能的示例图如下:

说明
  • 您可以进入在线咨询获取在线人工帮助。
    • 当前能力可在视觉智能开放平台有完整的免费产品体验,您可以单击立即试用对该能力进行更直观试用以及在线购买。
    • 阿里云视觉智能开放平台视觉 AI 能力 API 接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。

    应用场景

    • 娱乐应用:用户将自己的人脸和已获授权的合法图像中的人物人脸进行融合。
    • 影视制作:适用于影视制作公司,在后期制作中通过人脸融合提升制作效率与降低成本。
    • 影楼获客:适用于影楼或者个人摄影工作室,将客户的人脸融合到摄影样片中,达到试妆、试衣、试拍的效果。

    特色优势

    • 高保真、低违和效果:融合后的人脸保留了替换者人脸身份信息的视觉特征,而融入被替换者人脸中又无违和感。
    • 表情肤色一致性:融合后的人脸最大限度保留被替换者的面目表情、肤色一致性。
    • 支持复杂人脸角度:支持模版人脸偏侧一定角度,融合后的结果真实稳定。
    • 脸型适配:支持自适应的匹配用户脸的脸型,提升融合结果的辨识度。
    • 支持多人脸和指定人脸:支持模版图像中多个人脸,并指定每个人脸与目标人脸进行单独融合。

    接入指引

    1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。
    2. 开通能力:请确保您已开通人脸人体服务,若未开通服务请立即开通

    注意 于 2024 年 7 月 17 日及以后开通该能力的用户可直接调用,不需提交申请。 2024 年 7 月 17 日之前开通该服务的用户如需调用,可通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们添加到白名单。

    1. 创建 AccessKey:请确保您已创建 AccessKey,如果您使用的是子账号 AccessKey,您需要给子账号赋予 AliyunVIAPIFullAccess 权限,具体操作,请参见 RAM 授权
    2. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及 SDK 依赖信息,也可以下载完整的工程。
    3. 前提条件:已通过图像人脸融合模板增加接口(AddFaceImageTemplate)创建生成了 TemplateId。
    4. 开发接入步骤:
    • SDK 总览中选择您要接入使用的 SDK 语言。
    • 在对应语言的 SDK 文档中找到 AI 类目为人脸人体(facebody)的 SDK 包进行安装。
    • 参考文档中提供的示例代码进行适当修改后调用。
    1. 示例代码:该能力常用语言的示例代码,请参见图像人脸融合示例代码

    2. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。

    输入限制

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

    图像质量建议

    • 要求保证图像中的人脸清晰。图像中人脸尺寸建议大于 64×64 像素,人脸区域建议不大于全图区域的 2/3。
    • 建议图像中人脸五官区域轮廓完整,无明显遮挡。人脸融合算法支持人脸偏侧一定角度,在偏侧角度不超过 30 度的情况下能取得更佳效果。
    • 含有多人脸的图像,建议图像中人脸个数不超过 5 个。

    推荐图像示例: 不推荐图像示例:

    计费说明

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

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

    请求参数

    字段名称字段详情
    TemplateIdstring

    人脸模板的模板 ID。展开详情

    示例值:6cd509ea-54fa-4730-8e9d-c94cadcda048参考取值来源:
      AddFaceImageTemplate
      QueryFaceImageTemplate
    ImageURLstring

    待融合的人脸照片,仅在模板图为单人场景下使用。推荐使用上海地域的 OSS 链接,对于文件在本地或者非上海地域 OSS 链接的情况,请参见文件 URL 处理展开详情

    示例值:http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MergeImageFace/MergeImageFace-1.png
    ModelVersionstring

    提供两版模型,分别支持脸型适配(v1)与非脸型适配(v2)的效果,具有一定区分度。默认值为 v1(脸型适配版本)。

    示例值:v1
    AddWatermarkboolean

    是否添加水印。取值范围如下:展开详情

    示例值:False
    WatermarkTypestring

    水印类型。取值范围如下:展开详情

    示例值:EN
    MergeInfosarray<object>
    子级条数 <= 1000子级条数 >= 0

    返回参数

    字段名称字段详情
    RequestIdstring

    请求 ID。

    示例值:8473A5E5-488E-4612-800E-F95B42381570
    Dataobject

    返回的结果数据内容。

    返回说明

    SDK 参考

    阿里云视觉 AI 人脸人体类目下的图像人脸融合能力推荐使用 SDK 调用,支持多种编程语言,调用时请选择 AI 类目为人脸人体(facebody)的 SDK 包,文件参数通过 SDK 调用可支持本地文件及任意 URL,具体可参见 SDK 总览

    示例代码

    该能力常用语言的示例代码,请参见图像人脸融合示例代码

    变更历史
    暂无变更历史