腾讯云-人脸识别

连接器

需两次购买：①订购原厂商接口 ②订购易源会员包代理转发；可应用于智慧零售、智慧社区、智慧楼宇、在线身份认证等多种应用场景，充分满足各行业客户的人脸属性识别及用户身份确认等需求。

大厂接口

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

人脸比对

接入点说明

对两张图片中的人脸进行相似度比对，返回人脸相似度分数。阿里原接口订购地址：https://cloud.tencent.com/product/facerecognition

若您需要判断 “此人是否是某人”，即验证某张图片中的人是否是已知身份的某人，如常见的人脸登录场景，建议使用人脸验证接口。

若您需要判断图片中人脸的具体身份信息，如是否是身份证上对应的人，建议使用人脸核身·云智慧眼产品。

接口地址

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

返回格式JSON

请求方式POST/GET

请求参数

Header 参数

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

Post 表单

参数名称	类型	示例值	必须	描述
ImageA	String	/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQEB………………………………s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==	否	A 图片 base64 数据。若图片中包含多张人脸，只选取其中人脸面积最大的人脸。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
ImageB	String	/9j/4AAQSkZJRgABAQEAYABgAAD/4QAiRXhpZgAATU0AKgAAAAgAAQESAAMAAAABAAEAAAAAAAD/2……………………j3uf9z/Gvv6GOqYduMdV2Z+cYrK6OKXNPSXdfqfupqWqpeWMdxDIk1vMu6OWNt8cqnoVYcEe4rjf+Eir4/8A+CN3/Ima9/18H+dfTlfVYXEe1pKpa1z5HFYJUKsqV72P/9k=	否	B 图片 base64 数据。若图片中包含多张人脸，只选取其中人脸面积最大的人脸。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
UrlA	String	https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg	否	A 图片的 Url 。A 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。若图片中包含多张人脸，只选取其中人脸面积最大的人脸。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
UrlB	String	https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/3.jpg	否	B 图片的 Url 。B 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。若图片中包含多张人脸，只选取其中人脸面积最大的人脸。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
ds_id	String	-	是	数据源

返回参数

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

返回体

请求示例

查看我的 appKey 查看使用向导

Python / Java 等多语言示例

cURL

curl -X POST "https://connector.showapi.com/1948-3?appKey=YOUR_APPKEY" \
  -H "content-type: application/x-www-form-urlencoded" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "ImageA=%2F9j%2F4AAQSkZJRgABAQEAAQABAAD%2F2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH%2F2wBDAQEBAQEB%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6s8On6VYtLavb2MXh%2FwzptpNpTsi2Ut8ZPNcq0U%2FxuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI%2F%2F2Q%3D%3D&ImageB=%2F9j%2F4AAQSkZJRgABAQEAYABgAAD%2F4QAiRXhpZgAATU0AKgAAAAgAAQESAAMAAAABAAEAAAAAAAD%2F2%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6j3uf9z%2FGvv6GOqYduMdV2Z%2BcYrK6OKXNPSXdfqfupqWqpeWMdxDIk1vMu6OWNt8cqnoVYcEe4rjf%2BEir4%2F8A%2BCN3%2FIma9%2F18H%2BdfTlfVYXEe1pKpa1z5HFYJUKsqV72P%2F9k%3D&UrlA=https%3A%2F%2Fshowapi.oss-cn-hangzhou.aliyuncs.com%2Fmodleapi%2Flzh%2F2.jpg&UrlB=https%3A%2F%2Fshowapi.oss-cn-hangzhou.aliyuncs.com%2Fmodleapi%2Flzh%2F3.jpg&ds_id="

返回示例

JSON

{
  "showapi_res_error": "",
  "showapi_res_id": "0bac6e8d237f4f40bc3d073d3f137e39",
  "showapi_res_code": 0,
  "showapi_res_body": {
    "Response": {
      "RequestId": "59c60baf-30a0-4abf-93a5-d22bf59011d3",
      "Score": 6.072973251342773
    },
    "remark": "查询成功！",
    "ret_code": 0
  }
}

MCP 服务集成接口级

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

MCP JSON

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

OpenAPI 文档接口级

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

在线查看 YAML

下载 YAML

查看 JSON