> **平台**: 万维易源 (ShowAPI) > **接入方式**: 统一 API 网关 (HTTPS POST/GET) > **认证**: showapi_appid + showapi_sign > **文档**: https://www.showapi.com/apiGateway/view/1948/23 --- title: "人脸检测与属性分析 | 腾讯云 | 人脸识别 | API 市场 | 万维易源" canonical_url: "https://www.showapi.com/apiGateway/view/1948/23" last_updated: "2026-08-16T16:47:43.000Z" meta: description: "检测给定图片中的人脸（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" keywords: 大厂接口,showapi，万维易源，易源接口，api开放平台，开放api，api大全，api接口，接口中心，接口大全，开放平台，api，大数据，接口，API "og:description": "检测给定图片中的人脸（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" "og:title": "人脸检测与属性分析 | 腾讯云 | 人脸识别 | API 市场" --- * * * # **腾讯云-人脸识别** **连接器** 需两次购买：①订购原厂商接口 ②免费接口，注册后直接调用；可应用于智慧零售、智慧社区、智慧楼宇、在线身份认证等多种应用场景，充分满足各行业客户的人脸属性识别及用户身份确认等需求。 [大厂接口](https://www.showapi.com/market?search=%E5%A4%A7%E5%8E%82%E6%8E%A5%E5%8F%A3) **免费接口，注册即用，无需单独购买。 ** 在线调试 **连接器服务** 免费接口，注册后直接调用
原厂商
[腾讯云](https://cloud.tencent.com/product/ai-class)
转发服务商
昆明秀派科技有限公司
电话
400-998-8033
QQ
4009988033
邮箱
[service@showapi.com](mailto:service@showapi.com)
所属分类
IT技术
接入点
31 个
请求方式
POST
返回格式
JSON
**人脸检测与属性分析** 接入点说明 ``` 检测给定图片中的人脸（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)