人脸融合 接口接入指引

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

相关产品
人脸融合 产品页,含版本规格、价格与购买入口。

以下视频将为你介绍人脸融合选脸接入说明:

一、前提条件

·该指引适用于 图片人脸融合接口,支持单脸和多脸融合。

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

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

二、步骤一:选择接口

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

三、步骤二:输入参数

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

·ProjectId 参数:活动 ID。在 人脸融合控制台 素材管理页的活动列表中查看。

·ModelId 参数:素材 ID。在 人脸融合控制台 素材管理页的素材列表中查看。

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

·MergeInfos.N 参数:用户人脸图片、素材模板图的人脸位置信息。

·Image 或 Url 二选一,输入用户人脸图片。

·InputImageFaceRect 为用户人脸图片的人脸框,你可以通过调用 人脸检测接口 来获取 FaceRect 的人脸坐标信息,选取模板照片中的指定人脸,从而实现人脸融合,如不填会默认调用人脸检测并取最大脸。

·TemplateFaceID 为控制台上传的素材人脸 ID,单击素材管理素材缩略图左侧的三角符号,即可查看素材人脸和对应 FaceID。

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

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

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

四、步骤三:选择语言生成代码

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

五、步骤四:集成 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 的签名串生成工具,生成签名。

赞 (0)
上一篇 4天前
下一篇 4天前