接口接入指引

最近更新时间:2024-09-14 11:14:11

我的收藏
以下视频将为您介绍人脸融合选脸接入说明:


使用场景

该指引指导您开通人脸融合服务后,通过 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 的签名串生成工具,生成签名。