百度云-人脸识别

连接器

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

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

人脸检测

接入点说明

检测图片中的人脸并标记出位置信息，展示人脸的核心关键点信息，及72个关键点信息。原接口订购地址：https://cloud.baidu.com/product/face/private

接口地址

https://connector.showapi.com/2563-1?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/talor.jpg	是	图片信息(总数据大小应小于10M)，图片上传方式根据image_type来判断
image_type	String	URL	是	图片类型 BASE64:图片的base64值，base64编码后的图片数据，编码后的图片大小不超过2M； URL:图片的 URL地址( 可能由于网络等原因导致下载图片时间过长)； FACE_TOKEN: 人脸图片的唯一标识，调用人脸检测接口时，会为每个人脸图片赋予一个唯一的FACE_TOKEN，同一张图片多次检测得到的FACE_TOKEN是同一个。
face_fields	String	face_token	否	包括age,expression,face_shape,gender,glasses,landmark,landmark150, quality,eye_status,emotion,face_type,mask,spoofing信息逗号分隔. 默认只返回face_token、人脸框、概率和旋转角度
max_face_num	Number	1	否	最多处理人脸的数目，默认值为1，根据人脸检测排序类型检测图片中排序第一的人脸（默认为人脸面积最大的人脸），最大值120
face_type	String	LIVE	否	人脸的类型 LIVE表示生活照：通常为手机、相机拍摄的人像图片、或从网络获取的人像图片等 IDCARD表示身份证芯片照：二代身份证内置芯片中的人像照片 WATERMARK表示带水印证件照：一般为带水印的小图，如公安网小图 CERT表示证件照片：如拍摄的身份证、工卡、护照、学生证等证件图片默认LIVE
liveness_control	String	NONE	否	活体控制检测结果中不符合要求的人脸会被过滤 NONE: 不进行控制 LOW:较低的活体要求(高通过率低攻击拒绝率) NORMAL: 一般的活体要求(平衡的攻击拒绝率, 通过率) HIGH: 较高的活体要求(高攻击拒绝率低通过率) 默认NONE
face_sort_type	Number	0	否	人脸检测排序类型 0:代表检测出的人脸按照人脸面积从大到小排列 1:代表检测出的人脸按照距离图片中心从近到远排列默认为0
display_corp_image	Number	0	否	是否显示检测人脸的裁剪图base64值 0：不显示（默认） 1：显示当取值为1时，max_face_num字段的取值上限按5计算，即最多可返回5张人脸的裁剪图

返回参数

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

返回体

请求示例

查看我的 appKey 查看使用向导

Python / Java 等多语言示例

cURL

curl -X POST "https://connector.showapi.com/2563-1?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%2Ftalor.jpg&image_type=URL&face_fields=face_token&max_face_num=1&face_type=LIVE&liveness_control=NONE&face_sort_type=0&display_corp_image=0"

返回示例

JSON

{
  "showapi_res_error": "",
  "showapi_fee_num": 1,
  "showapi_res_code": 0,
  "showapi_res_id": "64783f270de376542f7f3e44",
  "showapi_res_body": {
    "timestamp": 1685602088,
    "cached": 0,
    "result": {
      "face_list": [
        {
          "face_probability": 1,
          "location": {
            "height": 79,
            "rotation": 5,
            "width": 72,
            "left": 214.34,
            "top": 70.98
          },
          "face_token": "61f6d912020371493ba89ac855355993",
          "angle": {
            "yaw": 3.07,
            "roll": 3.79,
            "pitch": 1.63
          }
        }
      ],
      "face_num": 1
    },
    "ret_code": 0,
    "remark": "调用成功",
    "error_code": 0,
    "log_id": 2888111915,
    "error_msg": "SUCCESS"
  }
}

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