文档中心 人脸融合 快速入门 选脸融合接入指引

选脸融合接入指引

最近更新时间:2019-10-09 15:15:58

使用场景

该指引指导您开通人脸融合服务后,通过 API 3.0 Explorer 在线调试页面调用选脸融合接口,并将对应语言的 SDK 集成到项目中使用。

前提条件

该指引仅适用 选脸融合接口 ,支持单脸和多脸融合。

在调用人脸融合接口前,您需要先在控制台 开通人脸融合服务

服务开通后,进入人脸融合 API 3.0 Explorer 在线调试页面,按照下面的操作步骤调用。

操作步骤

1. 选择接口

在左侧导航栏选中选脸融合接口。

2. 输入个人密钥

SecretId 和 SecretKey,在 API 密钥管理 中查看。

3. 输入参数

  • Region 参数:域名中的地域信息,该参数决定访问的接入点,如果域名中不指定地域信息则默认就近接入。建议域名和公共参数 Region 选择相同的地域:华南地区(广州),ap-guangzhou。

  • ProjectId 参数:活动 ID。在 人脸融控制台 的活动列表页查看。

  • ModelId 参数:素材 ID。在 人脸融控制台 的素材管理页查看。

  • RspImgType 参数:返回图像方式,取值 Url 或 base64,二选一。Url 有效期为30天。

  • MergeInfos.N 参数:用户人脸图片、素材模板图的人脸位置信息。a.Image 或 Url 二选一,输入用户人脸图片。b.InputImageFaceRect 参数为模板人脸框,通过调用 人脸检测接口 获取 FaceRect 的人脸坐标信息,您可以选取模板照片中的指定人脸,从而实现选脸融合,如不填会默认调用人脸检测并取最大脸。

  • TemplateFaceID 参数:控制台上传的素材人脸 ID。点击素材管理-素材缩略图左侧的三角符号,即可查看素材人脸和对应 FaceID。

    注意:

    以上操作为单脸融合,如需融合多人脸,请单击【添加】继续输入需要融合的人脸。

  • FuseProfileDegree 参数:脸型融合比例,取值范围[0,100] ,数值越高,融合后的脸型越像素材人物。如不填,则使用控制台中脸型参数数值。
  • FuseFaceDegree 参数:五官融合比例,取值范围[0,100] ,数值越高,融合后的五官越像素材人物。如不填,则使用控制台中脸型参数数值。

4. 选择语言生成代码

参数填完后,在代码生成中选择对应的语言。如需调整传入参数,修改参数值后重新生成代码。

5. 集成 SDK 到项目

参考右上角的 SDK 使用说明,将 SDK 引入到项目,即可使用上一步生成的代码来调用人脸融合服务。

注意事项

  1. SDK 调用方式公共参数时只需填写 Region 字段,建议域名和 Region 统一使用 “ap-guangzhou”。
  2. 人脸融合的接口请求包一般会超过1M,只能使用 V3 鉴权(TC3-HMAC-SHA256)。
  3. 图片/视频转 Base64 时,需要去掉相关前缀data:image/jpg;base64,和换行符\n。
  4. API 3.0 SDK 目前只支持 Node、Python、Java、PHP、Go、.Net。其他语言如 C++ ,需要自行实现 V3 鉴权 调用接口,建议使用 API 3.0 Explorer 的签名串生成工具,生成签名。