更新时间：2021 年 8 月 3 日

# 服务介绍

人脸融合 API 是 Face++ 提供的一种人像处理功能，它能够将“模板图”和“融合图”中的两张人脸的五官进行融合，融合后的图片中将包含融合图中的人脸特征以及模板图中的其他外貌特征与内容，实现“自己的脸融合到模板图中”的效果，广泛应用于H5或小程序的线上、线下营销推广活动等应用场景。

# 技术特色

• 响应快速：提供毫秒级响应速度
• 效果保障：拥有业界领先算法，融合效果自然逼真
• 模板数量不限额：不限制模板素材图片数量，不为营销方案设限
• 参数可调：融合比例可调，可灵活控制融合效果
• 响应快速：提供毫秒级响应

您可以通过 人脸融合 页面进行在线体验，支持本地上传图片，测试不同人脸图片的搜索效果。

# 应用场景

• 线上营销推广：以H5、小程序或APP的形式，将用户人脸与特定图片中的人脸融合，生成趣味换脸合成图，提高产品的互动性，让营销更有效率。具体包括（但不限于）婚纱照/穿越照换脸、影视作品融合照、游戏形象融合照。
• 线下活动推广：线下体验展馆（大型商场、主题展览、游乐场等）中开展人脸融合互动应用，增强用户参与感。
• 美颜相机：在相机、相机APP中魔法换脸等应用中增添人脸融合功能，使用户可以融合两张图片中包含的人脸，提升用户体验。

# 业务流程设计参考

# 基本流程说明

创建流程示意图如下：

1. 采集照片（融合图）：用户在 H5、小程序或 APP 端进行现场拍照，或使用已经拍好的人脸照片；
2. 融合图上传：用户的人脸照片上传到业务系统；
3. 调用融合接口：业务系统使用 Face++ 的密钥及模板图和用户上传的融合图，调用人脸融合 API 接口；
4. 融合结果图片：融合后的图片从 Face++ 返回业务系统；
5. 融合图片展示：融合后的图片最终通过手机、平板等客户端展示给用户。

# 设计建议

1. 建议由业务系统调用人脸融合接口， 将密钥（APIKey 和 APISecret）保存在服务端，更加安全，且便于统计、分析用户行为。
2. 如果应用中的模板图是固定的单张或多张，可以先调用人脸检测 API 接口获取模板图的人脸框存位置参数，并和模板图一起保存到业务系统的文件服务器上；调用接口时，可以直接传模板图文件（或 URL）和人脸框位置即可，不用再单独调取人脸检测 API 接口获取人脸框，以加快整体调用速度。
3. 图片大小及分辨率要求：图片大小不超过 500 K，分辨率不超过 1280x1280。

# 相关术语说明

1. 业务系统：接入 Face++ 平台的客户的服务端系统

2. 模板图：用于人脸融合的模板图片，融合出来的图片，除了脸部之外，都和模板图保持一致。

3. 融合图：用于人脸融合的用户图片，一般是由用户自己上传，与模板图融合之后，实现将“自己的脸融合到模板图中的效果”。

4. 人脸框位置：调用人脸融合 API 接口时，需要指定模板图的人脸框位置，这是必选参数，可以通过调用人脸检测 API 获取。融合图的人脸框位置是可选参数，可以不传。当融合图中有多张人脸时，会默认用最大的人脸进行融合。

5. 融合比例：可选参数，用于控制融合图在模板图中的比例的参数，数值越大，融合图中的人脸特征越多。默认值为 50。

# 接口说明

1. 人脸融合 API：用于融合两张图片
   主要参数：
   template_url/template_file/template_base64：指定模板图
   template_rectangle：指定模板图中人脸框位置（通过人脸检测 API 接口获取）
   merge_url/merge_file/merge_base64：指定融合图
   merge_rate：指定融合比例
   主要输出：
   result：融合后的图片，JPG 格式，base64 编码的二进制图片数据

2. 人脸检测 API：用于获取模板图的人脸框位置（模板图固定时，不需要调此接口）
   主要参数：
   image_url/ image_file/ image_base64：指定图片，一般是模板图
   主要输出：
   face_rectangle：图片中人脸的人脸框数据。

# 计费方式

人脸融合 API 有如下 3 种计费模式：

1. 按量计费：0.1 元/次，并发为 3 QPS（每秒最多接受 3 个请求）。

2. 包时计费：按天或按月订购，在付费时段内无限量调用，可灵活指定服务起始时间。并发数可根据实际需求开通。
   
   a. 按天：500 元 / 天 / QPS。如 5 QPS 使用 3 天，价格是 500 x 3 x 5 = 7500 元。
   
   b. 按月（30天）：10500 元 / 月 / QPS。如 1 QPS 使用 3 个月，价格是 10500 x 1 x 3 = 31500 元。

3. 次数包：人脸融合 API 次数包价格采用阶梯计费模式，具体价格如下，您可以根据业务量级购买相应的次数包，有效期 3 年，在有效期内可灵活调用。

详细计费说明可见 API 价目表。