有奖捉虫:云通信与企业服务文档专题,速来> HOT

功能描述

图片标签功能通过借助对象存储的持久化处理接口,实现对 COS 存量数据的图片标签识别,返回图片中置信度较高的主题标签。
注意
本接口属于 GET 请求,为同步请求方式,需携带签名,具体签名设置请参见 请求签名


授权说明

授权策略中 action 设置为 ci:CreateDetectLabelJob 。查看所有 action

服务开通

使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶

使用限制

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

费用说明

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

请求语法

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

请求内容

参数名称
类型
是否必选
描述
ObjectKey
string
对象文件名,例如 picture.jpg

返回内容

响应包体具体数据内容如下:
参数名称
类型
描述
RecognitionResult
Container
图片标签识别结果
RecognitionResult 节点内容:
参数名称
类型
描述
Labels
Container
标签信息
标签信息中包含如下内容:
参数名称
类型
描述
Confidence
Int
该标签的置信度分数,分数越高则该标签准确度越高
Name
String
识别出的图片标签

示例

请求

GET /picture.jpg?ci-process=detect-label HTTP/1.1
Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.com
Date: Tue, 03 Apr 2019 09:06:15 GMT
Authorization:XXXXXXXXXXXX

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 645
Date: Tue, 03 Apr 2018 09:06:16 GMT
Status: 200 OK
x-cos-request-id: NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****

<RecognitionResult>
<Labels>
<Confidence>88</Confidence>
<Name>玩具</Name>
</Labels>
<Labels>
<Confidence>87</Confidence>
<Name>毛绒玩具</Name>
</Labels>
<Labels>
<Confidence>77</Confidence>
<Name>泰迪熊</Name>
</Labels>
<Labels>
<Confidence>74</Confidence>
<Name>纺织品</Name>
</Labels>
<Labels>
<Confidence>15</Confidence>
<Name>艺术</Name>
</Labels>
</RecognitionResult>