> **平台**: 万维易源 (ShowAPI)
> **接入方式**: 统一 API 网关 (HTTPS POST/GET)
> **认证**: showapi_appid + showapi_sign
> **文档**: https://www.showapi.com/apis/face-recognition-detect-attribute-1948-23

---
title: "人脸识别 API 文档：人员库管理、人脸检测与比对|万维易源ShowAPI"
canonical_url: "https://www.showapi.com/apis/face-recognition-detect-attribute-1948-23"
last_updated: "2026-11-11T11:41:45.446Z"
meta:
  description: "提供完整的人脸识别 API，包括人员库创建与管理、人脸检测与属性分析、人脸比对、人脸搜索、活体检测、五官定位等。支持人员库复制、删除、修改、升级，以及口罩人脸对比、静态活体检测等高精度接口。适用于身份验证、安防监控、智能门禁等场景。"
  keywords: "人脸识别API, 人员库管理, 人脸检测, 人脸比对, 人脸搜索, 活体检测, 五官定位, 戴口罩人脸对比, 人脸静态活体检测, 人员库创建, 人员库删除, 腾讯云人脸识别"
  "og:description": "提供完整的人脸识别 API，包括人员库创建与管理、人脸检测与属性分析、人脸比对、人脸搜索、活体检测、五官定位等。"
  "og:title": "人脸识别 API 文档：人员库管理、人脸检测与比对"
---

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

**连接器**

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

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

**免费****本接口注册后默认可免费调用，为防止滥用设有使用档次限制。**

[**了解积分与档位详情 › **](https://www.showapi.com/free-api)

权益档次可使用平台积分兑换更高调用档位，多种积分获取方式请查看积分与档位详情。

在线调试

**连接器服务**

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

<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</dd>

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

</dl>

**人脸检测与属性分析**

接入点说明

```
检测给定图片中的人脸（Face）的位置、相应的面部属性和人脸质量信息，位置包括 (x，y，w，h)，面部属性包括性别（gender）、年龄（age）、表情（expression）、魅力（beauty）、眼镜（glass）、发型（hair）、口罩（mask）和姿态 (pitch，roll，yaw)，人脸质量信息包括整体质量分（score）、模糊分（sharpness）、光照分（brightness）和五官遮挡分（completeness）。阿里原接口订购地址：https://cloud.tencent.com/product/facerecognition
```

接口地址

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

返回格式JSON

请求方式POST

**请求参数**

**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/23)

cURL 复制

```
curl -X POST "https://connector.showapi.com/1948-23?appKey=YOUR_APPKEY" \
  -H "content-type: application/x-www-form-urlencoded" \
  -d "Image=%E5%9B%BE%E7%89%87base64&Url=&ds_id=&FaceAttributesType="
```

**返回示例**

JSON 复制

```
{
  "showapi_res_id": "",
  "showapi_res_error": "",
  "showapi_res_code": 0,
  "showapi_res_body": {
	"ret_code": 0,
    "remark": "调用成功！",
    "Response": {
      "FaceModelVersion": "3.0",
      "FaceDetailInfos": [
        {
          "FaceRect": {
            "Height": 301,
            "Width": 241,
            "Y": 58,
            "X": 140
          },
          "FaceDetailAttributesInfo": {
            "Age": 0,
            "HeadPose": {
              "Roll": 0,
              "Yaw": 0,
              "Pitch": 0
            },
            "Skin": {
              "Probability": 0,
              "Type": 0
            },
            "Eye": {
              "EyelidType": {
                "Probability": 0,
                "Type": 0
              },
              "EyeSize": {
                "Probability": 0,
                "Type": 0
              },
              "Glass": {
                "Probability": 0,
                "Type": 0
              },
              "EyeOpen": {
                "Probability": 0,
                "Type": 0
              }
            },
            "Beauty": 0,
            "Emotion": {
              "Probability": 0,
              "Type": 0
            },
            "Hair": {
              "Bang": {
                "Probability": 0,
                "Type": 0
              },
              "Length": {
                "Probability": 0,
                "Type": 0
              },
              "Color": {
                "Probability": 0,
                "Type": 0
              }
            },
            "Mask": {
              "Probability": 0,
              "Type": 0
            },
            "Shape": {
              "Probability": 0,
              "Type": 0
            },
            "Moustache": {
              "Probability": 0,
              "Type": 0
            },
            "Gender": {
              "Probability": 0,
              "Type": 0
            },
            "Hat": {
              "Style": {
                "Probability": 0,
                "Type": 0
              },
              "Color": {
                "Probability": 0,
                "Type": 0
              }
            },
            "Eyebrow": {
              "EyebrowLength": {
                "Probability": 0,
                "Type": 0
              },
              "EyebrowDensity": {
                "Probability": 0,
                "Type": 0
              },
              "EyebrowCurve": {
                "Probability": 0,
                "Type": 0
              }
            },
            "Nose": {
              "Probability": 0,
              "Type": 0
            },
            "Smile": 0,
            "Mouth": {
              "MouthOpen": {
                "Probability": 0,
                "Type": 0
              }
            }
          }
        }
      ],
      "RequestId": "1767e31d-11ed-4051-88d1-a1023f36b110",
      "ImageWidth": 508,
      "ImageHeight": 405
    }
  }
}
```

**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)