百度云-人脸识别

连接器

需两次购买：①订购原厂商接口 ②订购易源会员包代理转发；灵活应用于金融、泛安防、零售等行业场景，满足身份核验、人脸考勤、闸机通行等业务需求。

会员资源包统一计费，无需单独购买，开通会员包后可直接调用。

人脸库-人脸更新

接入点说明

用于对人脸库中指定用户，更新其下的人脸图像。
针对一个user_id执行更新操作，新上传的人脸图像将覆盖此user_id原有所有图像。

接口地址

https://connector.showapi.com/2563-5?appKey={your_appKey}查看密钥调用帮助

返回格式JSON

请求方式POST

请求参数

Header 参数

参数名称	类型	示例值	必须	描述
content-type	String	application/x-www-form-urlencoded	否

Post 表单

参数名称	类型	示例值	必须	描述
ds_id	String	-	是	数据源
image	String	https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/talor2.jpg	是	base64编码后的图片数据，需urlencode，每次只支持单张图片，编码后的图片大小不超过10m
image_type	String	URL	是	图片类型 BASE64:图片的base64值，base64编码后的图片数据，编码后的图片大小不超过2M； URL:图片的 URL地址( 可能由于网络等原因导致下载图片时间过长)； FACE_TOKEN: 人脸图片的唯一标识
group_id	String	9a1140c63a294	是	更新指定groupid下uid对应的信息
user_id	String	c47d91b_45f32b	是	用户id（由数字、字母、下划线组成），长度限制128b
user_info	String	-	否	用户信息，长度限制256位
quality_control	String	NONE	否	图片质量控制 NONE: 不进行控制 LOW:较低的质量要求 NORMAL: 一般的质量要求 HIGH: 较高的质量要求默认 NONE 若图片质量不满足要求，则返回结果中会提示质量检测失败
liveness_control	String	NONE	否	活体检测控制 NONE: 不进行控制 LOW:较低的活体要求(高通过率低攻击拒绝率) NORMAL: 一般的活体要求(平衡的攻击拒绝率, 通过率) HIGH: 较高的活体要求(高攻击拒绝率低通过率) 默认NONE 若活体检测结果不满足要求，则返回结果中会提示活体检测失败
action_type	String	UPDATE	否	操作方式 UPDATE: 会使用新图替换库中该user_id下所有图片, 若user_id不存在则会报错 REPLACE : 当user_id不存在时, 则会注册这个user_id的用户默认使用UPDATE

返回参数

该接口返回经 showapi_res_body 系统封装，业务数据均位于该对象内；系统级字段见。

返回体

请求示例

查看我的 appKey 查看使用向导

Python / Java 等多语言示例

cURL

curl -X POST "https://connector.showapi.com/2563-5?appKey=YOUR_APPKEY" \
  -H "content-type: application/x-www-form-urlencoded" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "ds_id=&image=https%3A%2F%2Fshowapi.oss-cn-hangzhou.aliyuncs.com%2Fmodleapi%2Flzh%2Ftalor2.jpg&image_type=URL&group_id=9a1140c63a294&user_id=c47d91b_45f32b&user_info=&quality_control=NONE&liveness_control=NONE&action_type=UPDATE"

返回示例

JSON

{
  "face_token": "2fa64a88a9d5118916f9a303782a97d3",
  "location": {
      "left": 117,
      "top": 131,
      "width": 172,
      "height": 170,
      "rotation": 4
  }
}

MCP 服务集成接口级

在 Cherry Studio、ChatBox 等支持 MCP 的客户端中配置，将 {your_appKey} 替换为真实 AppKey（AppKey 管理）。该服务覆盖本接口全部接入点。

MCP JSON

{
  "mcpServers": {
    "showapi-mcp-2563": {
      "url": "http://www.showapi.com.cn/mcp/2563/{your_appKey}"
    }
  }
}

OpenAPI 文档接口级

标准 OpenAPI 3.0 文档，覆盖本接口全部接入点，可导入 Apifox / Postman / Swagger UI，或供 AI Agent 直接消费。

在线查看 YAML

下载 YAML

查看 JSON