产品概述
产品优势
应用场景
接口接入指引
前提条件
官网账户使用前提
1. 首先使用腾讯云国际站账户进行 登录。
2. 进入API 密钥管理 页面，获取密钥信息。
3. 如果使用腾讯云国际站子账户密钥调用，需要腾讯云国际站主账户给子账户进行授权，如果使用主账户密钥请忽略该步骤。
4. 进入 用户列表 页面，选择对应的产品名称，单击授权。
5. 进入选择策略页面，勾选授权策略 QcloudFaceFusionFullAccess，单击确定。
说明：
如果子账户调用 API 接口没有被授权，调用的时候会提示"You are not authorized to perform this operation. Check your CAM policies, and ensure that you are using the correct access keys"
6. 进入 人脸融合控制台，完成开通服务。
说明：
如果不开通服务调用接口会提示"The billing status is unknown. Check whether the service has been activated in the console."
API 接口接入前提
说明：
由于是海外接入，请求耗时可能会相对国内较高，主要可能是海外图片等 URL 链接地址下载超时或请求传图片 base64 导致包体大传输耗时。
1. 请求域名使用：
facefusion.tencentcloudapi.com，会就近解析。2. 输入信息包含图片建议：
地址使用腾讯 COS 存储地址。
使用腾讯 COS 地址：腾讯服务下载图片地址走内网，可以减少下载图片耗时。
地址使用 CDN 地址：CDN 地址会涉及到回源，首次可能会出现下载超时失败的情况，针对这种情况，可以做重试请求。
如果输入参数为图片：建议传 base64 编码数据，减少下载耗时。
3. 输出图片：
如果请求不是在客户端（App、H5 等）发起，服务在请求时，通过 HTTP 的 header 中 X-Forwarded-For 字段传入客户端 IP，这样腾讯云服务会根据 IP 所在地就近返回生成结果的资源地址。
如果客户的服务本身就在客户端群体所在地，就不需要通过 X-Forwarded-For 字段传入客户端 IP，我们会通过客户服务的 IP 就近返回生成结果的资源地址。
API 接口调用指引
图片人脸融合基础版
里面有关于接口调用参数的说明描述，单击 “点击调试” 可进入 API Explorer 在线测试接口，测试之前需要在控制台上传素材，获取到 ProjectId 跟 ModelId。
接口调用测试
步骤一：选择接口
在左侧导航栏选中图片人脸融合接口。
步骤二：安装对应语言的 SDK
目前只支持 Node.js、Python、Java、PHP、Go、.Net、C++ 开发语言。
单击代码示例 ，选择接入方式和开发语言，如果接入方式选择 SDK 或者 SDK Common Client ，需要安装对应开发语言的 SDK，可通过 SDK 信息和 SDK 使用说明 安装 SDK。
步骤三：输入参数并复制调用示例
1. 在输入参数中，输入参数信息，复制参考示例代码，调整“SecretId”和“SecretKey”参数进行调用。
Region 参数：该参数决定访问的接入点，可选择就近地域。
ProjectId 参数：活动 ID。在 人脸融合控制台 素材管理页的活动列表中查看。
ModelId 参数：素材 ID。在 人脸融合控制台 素材管理下的活动列表中，单击操作下面的素材管理，可查看列表中的素材 ID。
MergeInfos.N 参数：用户人脸图片、素材模板图的人脸位置信息。
Image 或者 Url 参数： image（base64 图片数据）和 URL 必须提供一个，如果都提供以 URL 为准。
TemplateFaceID 参数： 素材图的人脸 ID，如下图单击查看，即可查看素材人脸和对应 FaceID（当素材图片中存在多张人脸的时候指定人脸进行融合）。
InputImageFaceRect 参数： 为用户图片的人脸位置坐标（人脸框），表示指定用户图片的人脸，从而实现人脸融合，如不填会默认调用人脸检测并取最大脸。
RspImgType 参数：返回图像方式（URL 或 base64) ，二选一。URL 有效期为7天。
2. 输入参数之后复制调用示例，如下图：
说明：
如何进行多张人脸融合
最多支持融合素材图中的6张人脸，如果不指定人脸，会默认调用人脸检测并取最大脸。
如果有多张人脸进行融合，可通过单击添加，继续输入需要融合的人脸，通过指定素材图的 TemplateFaceID 与用户图进行融合。
文档反馈