腾讯云-人脸识别

连接器

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

大厂接口

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

人员库-创建人员库

接入点说明

用于创建一个空的人员库，如果人员库已存在返回错误。可根据需要创建自定义描述字段，用于辅助描述该人员库下的人员信息。1个APPID下最多创建2万个人员库（Group）、最多包含1000万张人脸（Face），单个人员库（Group）最多包含100万张人脸（Face）。

接口地址

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

返回格式JSON

请求方式POST/GET

请求参数

Header 参数

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

Post 表单

参数名称	类型	示例值	必须	描述
GroupName	String	测试1号	是	人员库名称，[1,60]个字符，可修改，不可重复。
GroupId	String	1	是	人员库 ID，不可修改，不可重复。支持英文、数字、-%@#&_，长度限制64B。
Tag	String	测试tag	否	人员库信息备注，[0，40]个字符。
GroupExDescriptions	List	["测试x","测试xx","测试xxx"]	否	人员库自定义描述字段，用于描述人员库中人员属性，该人员库下所有人员将拥有此描述字段。最多可以创建5个。每个自定义描述字段支持[1,30]个字符。在同一人员库中自定义描述字段不可重复。例：设置某人员库“自定义描述字段”为["学号","工号","手机号"]，则该人员库下所有人员将拥有名为“学号”、“工号”、“手机号”的描述字段，可在对应人员描述字段中填写内容，登记该人员的学号、工号、手机号等信息。
ds_id	String	-	是	数据源

返回参数

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

返回体

请求示例

查看我的 appKey 查看使用向导

Python / Java 等多语言示例

cURL

curl -X POST "https://connector.showapi.com/1948-7?appKey=YOUR_APPKEY" \
  -H "content-type: application/x-www-form-urlencoded" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "GroupName=%E6%B5%8B%E8%AF%951%E5%8F%B7&GroupId=1&Tag=%E6%B5%8B%E8%AF%95tag&GroupExDescriptions=%5B%22%E6%B5%8B%E8%AF%95x%22%2C%22%E6%B5%8B%E8%AF%95xx%22%2C%22%E6%B5%8B%E8%AF%95xxx%22%5D&ds_id="

返回示例

JSON

{
  "showapi_res_error": "",
  "showapi_res_id": "02b523f73b8447bf91c52007a6d4d51c",
  "showapi_res_code": 0,
  "showapi_res_body": {
    "Response": {
      "RequestId": "cec49d95-83b3-424e-903e-ed251aa45f0b"
    },
    "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