总体说明

如果您已经用百度的公有云接口完成产品验证，希望迁移到百度的私有化服务上，可以参考此说明文档。

因为线上线下依赖服务的不同，私有化版的人脸服务提供的能力会与公有云版有一些差异。 若您想了解更多公有云转私有化的内容，请提交工单联系百度的工作人员

注意事项

差异如下：

1、关于接口调用

• 私有化服务不需要通过AK/SK来获取token再请求，而是可以直接调用接口，具体调用方式参考接口说明文档
• 私有化的接口在请求时，需要替换成下接口地址并在请求中带上appid的参数。appid的值可以自由指定，但需要在请求接口时都使用同一个值。
• 不支持image_type参数中的URL，请使用BASE64和FACE_TOKEN参数（FACE_TOKEN参数使用也有一定限制见下文私有化FACE_TOKEN处理逻辑）

3、公有云服务使用Face_token，私有化时需要注意以下问题

Q1：如何使用face_token

• 私有化环境下想要使用Face_token,需要在生成Face_token的时候（即调用人脸检测、人脸注册接口时），要加face_field字段：feature，用于预先提取特征，方便使用face_token进行特征分析

Q2：调用detect接口生成的face_token无法用来调用比对、搜索、活体等接口，应该怎么解决？

• 调用比对、搜索接口：调用detect、add接口检测时，要加face_field字段：feature，用于预先提取特征，方便使用face_token进行比对
• 调用活体接口：调用detect、add接口时，使用liveness_control参数，用于预先提取活体特征，进行活体分析
• 获取人脸属性：希望通过face_token获取什么属性，detect的阶段就需要在field参数中增加哪个参数

附：私有化Face_token处理逻辑

在使用图片进行请求时，人脸服务会将face_token和返回的人脸信息一起放入存储。后续使用face_token请求时，也只能获取当时存储人脸信息。

私有化时如果需要使用face_token请求人脸搜索接口，则需要在请求检测接口的face_filed中加入feature项

• 第一次请求(BASE64输入)

  （1）生成FACE_TOKEN

  （2）将检测的人脸信息(特征、质量、活体、属性等信息中的一项或几项)和FACE_TOKEN一起存储

  （3）返回FACE_TOKEN

• 第二次请求(FACE_TOKEN输入)

  （1）依据FACE_TOKEN获取上次检测出来的人脸信息

  （2）判断存储的人脸信息能否覆盖该次请求中需要获取的信息

  • 能-返回成功
  • 否-返回失败(pic storage not support) 错误码222305

流程步骤

私有化接口调用一共分为如下几步：

Step1：准备好本地GPU服务器

GPU显卡类型与线上尽量保持一致，若您线上使用的是P4/GTX系列，则线下尽量也使用P4/GTX系列；若您线上使用的是T4/RTX系列，则线下尽量也使用T4/RTX系列。

Step2：申请私有化部署包

在百度云控制台发起私有化部署包申请，待百度工作人员审批后即可下载使用。

Step3：创建Appid

通过调用“创建用户组”接口来创建appid，即：在“创建用户组”接口中可以自定义一个Appid，当组创建成功后，此Appid即可生效。

Step4：参考接口文档进行接口调用

Step5：完成调用