腾讯云-人脸核身

连接器

需两次购买：①订购原厂商接口 ②订购易源会员包代理转发；依托于证件OCR识别、活体检测、1：1人脸比对等AI技术，实现自然人真实身份核验的产品。秒级确认用户身份，帮助提升业务办理效率，降低人力成本。

大厂接口

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

活体人脸比对

接入点说明

传入视频和照片，先判断视频中是否为真人，判断为真人后，再判断该视频中的人与上传照片是否属于同一个人

接口地址

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

返回格式JSON

请求方式POST/GET

请求参数

Header 参数

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

Post 表单

参数名称	类型	示例值	必须	描述
ds_id	String	-	是	数据源
ImageBase64	String	/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQE…………………………TaHcN/8AMH/wTn+E1x8QfH+kveeH2u9B8NaFf6pqtoMLZ6do9j9n1m7bWUBEk0Fz/YosreERKZprsxBkZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==	是	用于人脸比对的照片，图片的BASE64值； BASE64编码后的图片数据大小不超过3M，仅支持jpg、png格式。
VideoBase64	String	AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAEDv1tZGF0AAACrgYF//+q3EXpvebZSLeWLNgg2SPu73gyNjQgLSBjb3JlIDE1MiByMjg1MSBiYTI0ODk5IC0gSC4yNjQvTVBFRy00IEFWQyBjb2RlYyAtIENvcHl……………………aGRscgAAAAAAAAAAbWRpcmFwcGwAAAAAAAAAAAAAAAAtaWxzdAAAACWpdG9vAAAAHWRhdGEAAAABAAAAAExhdmY1Ny44MS4xMDA=	是	用于活体检测的视频，视频的BASE64值； BASE64编码后的大小不超过5M，支持mp4、avi、flv格式。
LivenessType	String	SILENT	是	活体检测类型，取值：LIP/ACTION/SILENT。 LIP为数字模式，ACTION为动作模式，SILENT为静默模式，三种模式选择一种传入。
ValidateData	String	-	否	数字模式传参：数字验证码(1234)，需先调用接口获取数字验证码；动作模式传参：传动作顺序(2,1 or 1,2)，需先调用接口获取动作顺序；静默模式传参：空。

返回参数

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

返回体

请求示例

查看我的 appKey 查看使用向导

Python / Java 等多语言示例

cURL

curl -X POST "https://connector.showapi.com/2547-9?appKey=YOUR_APPKEY" \
  -H "content-type: application/x-www-form-urlencoded" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "ds_id=&ImageBase64=%2F9j%2F4AAQSkZJRgABAQEAAQABAAD%2F2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH%2F2wBDAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQE%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%A6TaHcN%2F8AMH%2FwTn%2BE1x8QfH%2BkveeH2u9B8NaFf6pqtoMLZ6do9j9n1m7bWUBEk0Fz%2FYosreERKZprsxBkZgsv9cPw88B393%2Bzr4A0BW0yx8R%2FtC%2FEb4e6jcJJDK8%2BiW8V4s8On6VYtLavb2MXh%2FwzptpNpTsi2Ut8ZPNcq0U%2FxuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI%2F%2F2Q%3D%3D&VideoBase64=AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAEDv1tZGF0AAACrgYF%2F%2F%2Bq3EXpvebZSLeWLNgg2SPu73gyNjQgLSBjb3JlIDE1MiByMjg1MSBiYTI0ODk5IC0gSC4yNjQvTVBFRy00IEFWQyBjb2RlYyAtIENvcHl%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6%E2%80%A6aGRscgAAAAAAAAAAbWRpcmFwcGwAAAAAAAAAAAAAAAAtaWxzdAAAACWpdG9vAAAAHWRhdGEAAAABAAAAAExhdmY1Ny44MS4xMDA%3D&LivenessType=SILENT&ValidateData="

返回示例

JSON

{
    "showapi_res_error":"",
    "showapi_res_id":"012a7b26c9094c40b830875139470b1e",
    "showapi_res_code":0,
    "showapi_res_body":{
        "Response":{
            "Result":"Success",
            "Description":"成功",
            "BestFrameBase64":"Imagebase64",
            "Sim":"89.88",
            "RequestId":"f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a"
        },
        "remark":"调用成功！",
        "ret_code":0
    }
}

MCP 服务集成接口级

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

MCP JSON

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

OpenAPI 文档接口级

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

在线查看 YAML

下载 YAML

查看 JSON