腾讯云-人脸识别

连接器

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

大厂接口

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

人脸检测与属性分析

接入点说明

检测给定图片中的人脸（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}查看密钥调用帮助

返回格式JSON

请求方式POST

请求参数

Header 参数

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

Post 表单

参数名称	类型	示例值	必须	描述
Image	String	图片base64	否	图片 base64 数据，base64 编码后大小不可超过5M。 jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
Url	String	-	否	图片的 Url 。对应图片 base64 编码后大小不可超过5M。 jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 Url、Image必须提供一个，如果都提供，只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
ds_id	String	-	是
FaceAttributesType	String	-	否	是否返回年龄、性别、情绪等属性。合法值为（大小写不敏感）：None、Age、Beauty、Emotion、Eye、Eyebrow Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。 None为不需要返回。默认为 None。需要将属性组成一个用逗号分隔的字符串，属性之间的顺序没有要求。

返回参数

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

返回体

请求示例

查看我的 appKey 查看使用向导

Python / Java 等多语言示例

cURL

curl -X POST "https://connector.showapi.com/1948-23?appKey=YOUR_APPKEY" \
  -H "content-type: application/x-www-form-urlencoded" \
  -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 管理）。该服务覆盖本接口全部接入点。

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