> **平台**: 万维易源 (ShowAPI)
> **接入方式**: 统一 API 网关 (HTTPS POST/GET)
> **认证**: showapi_appid + showapi_sign
> **文档**: https://www.showapi.com/apiGateway/view/1948/4

---
title: "基于人员库 | 人脸搜索 | 腾讯云 | 人脸识别 | API 市场 | 万维易源"
canonical_url: "https://www.showapi.com/apiGateway/view/1948/4"
last_updated: "2026-08-16T16:41:55.310Z"
meta:
  description: "用于对一张待识别的人脸图片，在一个或多个人员库中识别出最相似的 TopN 人员，识别结果按照相似度从大到小排序。单次搜索的人员库人脸总数量不得超过 100 万张。 此接口需与人员库管理相关接口结合使用。"
  keywords: 大厂接口,showapi，万维易源，易源接口，api开放平台，开放api，api大全，api接口，接口中心，接口大全，开放平台，api，大数据，接口，API
  "og:description": "用于对一张待识别的人脸图片，在一个或多个人员库中识别出最相似的 TopN 人员，识别结果按照相似度从大到小排序。单次搜索的人员库人脸总数量不得超过 100 万张。 此接口需与人员库管理相关接口结合使用。"
  "og:title": "基于人员库 | 人脸搜索 | 腾讯云 | 人脸识别  |  API 市场"
---

*

*

*

# **腾讯云-人脸识别**

**连接器**

需两次购买：①订购原厂商接口 ②免费接口，注册后直接调用；可应用于智慧零售、智慧社区、智慧楼宇、在线身份认证等多种应用场景，充分满足各行业客户的人脸属性识别及用户身份确认等需求。

[大厂接口](https://www.showapi.com/market?search=%E5%A4%A7%E5%8E%82%E6%8E%A5%E5%8F%A3)

**免费接口，注册即用，无需单独购买。 **

在线调试

**连接器服务**

免费接口，注册后直接调用

<dl>

<dt>原厂商</dt>
<dd>[腾讯云](https://cloud.tencent.com/product/ai-class)</dd>

<dt>转发服务商</dt>
<dd>昆明秀派科技有限公司</dd>

<dt>电话</dt>
<dd>400-998-8033</dd>

<dt>QQ</dt>
<dd>4009988033</dd>

<dt>邮箱</dt>
<dd>[service@showapi.com](mailto:service@showapi.com)</dd>

</dl>

<dl>

<dt>所属分类</dt>
<dd>IT技术</dd>

<dt>接入点</dt>
<dd>31 个</dd>

<dt>请求方式</dt>
<dd>POST/GET</dd>

<dt>返回格式</dt>
<dd>JSON</dd>

</dl>

**基于人员库-人脸搜索**

接入点说明

```
用于对一张待识别的人脸图片，在一个或多个人员库中识别出最相似的 TopN 人员，识别结果按照相似度从大到小排序。单次搜索的人员库人脸总数量不得超过 100 万张。 此接口需与人员库管理相关接口结合使用。
```

接口地址

https://connector.showapi.com/1948-4?appKey={your\_appKey} [查看密钥](https://www.showapi.com/console#/myApp) [调用帮助](https://www.showapi.com/helpcenter/view#/3960/1)

返回格式JSON

请求方式POST/GET

**请求参数**

**Header 参数**

| |
|

| |
|

**Post 表单**

| |
|

| |
|
| |
| |
| |
| |
| |
| |

**返回参数**查看公共返回参数

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

**返回体**

| |
|

| |
|
| |
| |
| |
| |
| |
| |
| |

**请求示例**

[查看我的 appKey](https://www.showapi.com/console#/myApp) [查看使用向导](https://www.showapi.com/helpcenter/view#/3960/1) [Python / Java 等多语言示例](https://www.showapi.com/apitest/market/1948/4)

cURL 复制

```
curl -X POST "https://connector.showapi.com/1948-4?appKey=YOUR_APPKEY" \
  -H "content-type: application/x-www-form-urlencoded" \
  -d "GroupIds=%5B%222%22%5D&Image=%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&Url=https%3A%2F%2Fshowapi.oss-cn-hangzhou.aliyuncs.com%2Fmodleapi%2Flzh%2F2.jpg&MaxFaceNum=&MinFaceSize=&MaxPersonNum=&ds_id="
```

**返回示例**

JSON 复制

```
{
    "showapi_res_error":"",
    "showapi_res_id":"c4d640dc5d764912be54bd477e2f6fca",
    "showapi_res_code":0,
    "showapi_res_body":{
        "Response":{
            "Results":[
                {
                    "Candidates":[
                        {
                            "PersonId":"1001",
                            "FaceId":"2875093635484912302",
                            "Score":100
                        }
                    ],
                    "FaceRect":{
                        "X":370,
                        "Y":46,
                        "Width":75,
                        "Height":75
                    }
                }
            ],
            "FaceNum":1,
            "RequestId":"57b42b73-b978-45b9-8095-8f50e9642d35"
        },
        "remark":"查询成功！",
        "ret_code":0
    }
}
```

**MCP 服务集成**接口级

在 Cherry Studio、ChatBox 等支持 MCP 的客户端中配置，将 {your\_appKey} 替换为真实 AppKey（ [AppKey 管理](https://www.showapi.com/console#/myApp)）。该服务覆盖本接口全部接入点。

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](https://www.showapi.com/openapi/market/1948.yaml) [下载 YAML](https://www.showapi.com/openapi/market/1948.yaml) [查看 JSON](https://www.showapi.com/openapi/market/1948.json)