数据万象人体识别-AI 内容识别-API 中心-腾讯云

功能概述
腾讯云数据万象通过 AIBodyRecognition 接口识别并输出画面中人体，输出其位置（矩形框）和置信度。
注意：
本接口属于 GET 请求，为同步请求方式，需携带签名，具体签名设置请参见 请求签名。
授权说明
通过子账号使用时，需要授予 ci:CreateBodyRecognitionJob权限，详情请参见 数据万象 action。
服务开通
使用该功能需提前开通数据万象，并绑定存储桶。详情请参见 绑定存储桶。
使用该功能需提前通过控制台或接口开通 AI 内容识别服务 。详情请参见 开通 AI 内容识别服务。
使用限制
使用该接口时，请先确认相关限制条件。详情请参见 使用限制。
﻿
请求语法
GET /ObjectKey?ci-process=AIBodyRecognition&detect-url=<detect-url> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
说明：
Authorization:Auth String ，详情请参见 请求签名 文档。
请求内容
参数名称
描述
类型
是否必选
ci-process
数据万象处理能力，人体识别固定为 AIBodyRecognition 
String
是
ObjectKey
对象文件名，例如 picture.jpg
String
否
detect-url
您可以通过填写 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
String
否
请求头
此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。
请求体
该请求无请求体。
响应
响应头
此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。
响应体
该响应体返回为 application/xml 数据，具体的数据内容如下：
节点名称（关键字）
父节点
描述
类型
RecognitionResult
无
保存 Logo 识别结果的容器
Container
Response 的内容：
节点名称（关键字）
父节点
描述
类型
Status
RecognitionResult
人体识别结果。0表示未识别到，1表示识别到
Int
PedestrianInfo
RecognitionResult
人体识别结果，可能有多个
Container
LogoInfo 节点内容：
节点名称（关键字）
父节点
描述
类型
Name
PedestrianInfo
识别类型，人体识别默认：person
String
Score
PedestrianInfo
人体的置信度，取值范围为[0-100]。值越高概率越大
String
Location
PedestrianInfo
图中识别到人体的坐标
Container
Location 节点内容：
节点名称（关键字）
父节点
描述
类型
Point
Location
人体坐标点（X 坐标,Y 坐标）
String
示例
请求
GET /?ci-process=RecognizeLogo&detect-url=<detect-url> HTTP/1.1
Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
响应
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 414641
Date: xxxxxx
Server: tencent-ci
x-cos-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhfMjc=
﻿
<RecognitionResult>
    <Status>1</Status>
    <PedestrianInfo>
        <Name>person</Name>
        <Score>90</Score>
        <Location>
            <Point>162,266</Point>
            <Point>162,716</Point>
            <Point>392,716</Point>
            <Point>392,266</Point>
        </Location>
        <Name>person</Name>
        <Score>89</Score>
        <Location>
            <Point>682,162</Point>
            <Point>682,479</Point>
            <Point>783,479</Point>
            <Point>783,162</Point>
        </Location>
    </PedestrianInfo>
</RecognitionResult>
﻿

参数名称	描述	类型	是否必选
ci-process	数据万象处理能力，人体识别固定为 AIBodyRecognition	String	是
ObjectKey	对象文件名，例如 picture.jpg	String	否
detect-url	您可以通过填写 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`	String	否

节点名称（关键字）	父节点	描述	类型
RecognitionResult	无	保存 Logo 识别结果的容器	Container

人体识别

本页目录：

功能概述

授权说明

服务开通

使用限制

请求语法

请求内容

请求头

请求体

响应

响应头

响应体

示例

请求

响应