文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>API 中心>数据万象>AI 内容识别>宠物识别

宠物识别

最近更新时间：2025-09-10 15:34:15

我的收藏

本页目录：

功能描述

腾讯云数据万象通过 detect-pet 接口识别并输出画面中宠物，输出其位置（矩形框）和置信度。

授权说明

通过子账号使用时，需要在 授权策略 的 action 中添加 ci:CreatePetDetectJob 权限。数据万象支持的所有操作接口请参见 CI action。

服务开通

使用该功能需提前 绑定存储桶，开通数据万象服务。
注意：
数据万象绑定后，如果您手动对存储桶进行数据万象的解绑操作，将无法继续使用该功能。

使用限制

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

费用说明

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


请求

请求示例

GET /<ObjectKey>?ci-process=detect-pet HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明：
Authorization: Auth String，详情请参见 请求签名 文档。

请求参数

参数名称
描述
类型
是否必选
ObjectKey
对象文件名，例如 picture.jpg
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
Container 节点 Response 的内容：
节点名称（关键字）
父节点
描述
类型
ResultInfo
Response
保存结果的容器
Container
Container 节点 ResultInfo 的内容：
节点名称（关键字）
父节点
描述
类型
Score
Response.ResultInfo
分数，范围在0 - 100之间，值越高，表示目标为相应结果的可能性越高
int
Name
Response.ResultInfo
宠物名称
string
Location
Response.ResultInfo
保存宠物位置的容器
Container
Container 节点 Location 的内容：
节点名称（关键字）
父节点
描述
类型
X
Response.ResultInfo.Location
x 轴坐标
int
Y
Response.ResultInfo.Location
y 轴坐标
int
Height
Response.ResultInfo.Location
(x,y)坐标距离高度
int
Width
Response.ResultInfo.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=************************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=****************************************&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>
中国站
目录