数据万象宠物识别-API 文档-文档中心-腾讯云

功能描述
腾讯云数据万象通过 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>
﻿

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

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

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

宠物识别

本页目录：

功能描述

授权说明

服务开通

使用限制

费用说明

请求

请求示例

请求参数

请求头

请求体

响应

响应头

响应体

错误码

实际案例

请求

响应