宠物识别

最近更新时间: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>