数据万象
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 数据万象 > API 文档 > AI 内容识别 > 宠物识别

宠物识别

最近更新时间：2024-04-09 15:54:34

我的收藏

本页目录：

功能描述

腾讯云数据万象通过 detect-pet 接口识别并输出画面中宠物，输出其位置（矩形框）和置信度。
注意：
本接口属于 GET 请求，为同步请求方式，需携带签名，具体签名设置请参见 请求签名。

授权说明

通过子账号使用时，需要授予ci:CreatePetDetectJob权限，详情请参见 数据万象 action。

服务开通

使用该功能需提前开通数据万象，并绑定存储桶。详情请参见 绑定存储桶。
使用该功能需提前通过控制台或接口开通 AI 内容识别服务 。详情请参见 开通 AI 内容识别服务。

使用限制

使用该接口时，请先确认相关限制条件。详情请参见 使用限制。

费用说明

该接口为付费服务，产生的费用将由数据万象收取，详细计费说明可参见 内容识别费用。


请求

请求示例

GET /<ObjectKey>?ci-process=detect-pet HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>

请求参数

参数名称
描述
类型
是否必选
ci-process
数据万象处理能力，宠物识别固定为 detect-pet
String
是

请求头

此接口仅使用公共请求头部。

请求体

该请求无请求体。

响应

响应头

此接口仅返回公共响应头部。

响应体

该响应体返回为 application/xml 数据，包含完整节点数据的内容展示如下：
<Response>
        <ResultInfo>
                <Score>64</Score>
                <Name>dog</Name>
                <Location>
                        <X>59</X>
                        <Y>51</Y>
                        <Height>225</Height>
                        <Width>175</Width>
                </Location>
        </ResultInfo>
        <ResultInfo>
                ...
        </ResultInfo>
</Response>
具体的数据内容如下：
节点名称（关键字）
父节点
描述
类型
Response
无
保存结果的容器
Container
Response 的内容：
节点名称（关键字）
父节点
描述
类型
ResultInfo
Response
保存结果的容器
Container
Score
ResultInfo
分数，范围在0-100之间，值越高，表示目标为相应结果的可能性越高
int
Name
ResultInfo
宠物名称
string
Location
ResultInfo
保存宠物位置的容器
Container
X
Location
x轴坐标
int
Y
Location
y轴坐标
int
Height
Location
(x,y)坐标距离高度
int
Width
Location
(x,y)坐标距离长度
int

错误码

错误码
描述
HTTP状态码
FailedOperation.NoObjectDetected
未检测到目标
400 Bad Request
InternalError
文件下载失败/其他未知错误
400 Bad Request

实际案例

请求

GET /test.jpg?ci-process=detect-pet HTTP/1.1
Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****&x-cos-security-token=mUvZ3UZ4XbqDyK6iGsTFBQoHNO***
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 359
Date: Mon, 26 Apr 2021 02:19:16 GMT
Server: tencent-image
x-ci-request-id: NjA4NjIzMjNfOTBmYTUwNjRfNjAx****

<Response>
        <ResultInfo>
                <Score>64</Score>
                <Name>dog</Name>
                <Location>
                        <X>59</X>
                        <Y>51</Y>
                        <Height>225</Height>
                        <Width>175</Width>
                </Location>
        </ResultInfo>
        <ResultInfo>
                <Score>62</Score>
                <Name>dog</Name>
                <Location>
                        <X>237</X>
                        <Y>60</Y>
                        <Height>208</Height>
                        <Width>177</Width>
                </Location>
        </ResultInfo>
</Response>

中国站