简介
本文档提供关于人体识别的相关 API 概览以及 SDK 示例代码。
API | 操作描述 |
人体识别 |
人体识别
功能说明
腾讯云数据万象通过 AIBodyRecognition 接口识别并输出画面中人体，输出其位置（矩形框）和置信度。图片人体识别请求包属于 GET 请求，请求时需要携带签名。
示例代码
def cos_ai_body_recognition():# 人体识别# demo地址：https://github.com/tencentyun/cos-python-sdk-v5/blob/master/demo/ai_recognition_demo.py#L99response, data = client.cos_ai_body_recognition(Bucket=bucket_name, ObjectKey="test.jpg", DetectUrl="https://test-125000000.cos.ap-chongqing.myqcloud.com/test.jpeg" )print(response)print(data)return response, data
参数说明
调用 cos_ai_body_recognition 函数，具体请求参数如下：
参数名称 | 参数描述 | 类型 | 是否必填 |
Bucket | 存储桶名称 | String | 是 |
ObjectKey | 设置对象名称。ObjectKey与DetectUrl必选一个 | String | 否 |
DetectUrl | 您可以通过填写 detect-url 处理任意公网可访问的图片链接。不填写 detect-url 时，后台会默认处理 ObjectKey ，填写了 detect-url 时，后台会处理 detect-url 链接，无需再填写 ObjectKey，detect-url 示例： http://www.example.com/abc.jpg，需要进行 UrlEncode，处理后为http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg。ObjectKey与DetectUrl必选一个 | String | 否 |
返回结果说明
response 为响应头，data 为人体识别结果，数据类型都为 dict。
response内容
响应体data
由于接口默认返回xml内容，解析结果都为string类型，以下描述为字段的真实类型。具体数据内容如下：
参数名称 | 参数描述 | 类型 |
Status | 人体识别结果。0表示未识别到，1表示识别到 | Integer |
PedestrianInfo | 人体识别结果，可能有多个 | Container Array |
PedestrianInfo 节点内容：
参数名称 | 参数描述 | 类型 |
Name | 识别类型，人体识别默认：person | String |
Score | 人体的置信度，取值范围为[0-100]。值越高概率越大。 | String |
Location | 图中识别到人体的坐标 | Container Array |
Location 节点内容：
参数名称 | 参数描述 | 类型 |
Point | 人体坐标点（X坐标,Y坐标） | String Array |
