图片标签

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

我的收藏

功能概述

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

授权说明

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

服务开通

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

使用限制

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

费用说明

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


请求

原图存储在COS:
GET /<ObjectKey>?ci-process=detect-label&scenes=<scenes> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
原图来自其他链接:
GET /?ci-process=detect-label&scenes=<scenes>&detect-url=<detect-url> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明
Authorization:Auth String ,详情请参见 请求签名 文档。

请求内容

参数名称
类型
是否必选
描述
ObjectKey
string
对象文件名,例如 picture.jpg
ci-process
string
固定值detect-label
scenes
String
本次调用支持的识别场景,可选值如下:
web,针对网络图片优化;
camera,针对手机摄像头拍摄图片优化;
album,针对手机相册、网盘产品优化;
news,针对新闻、资讯、广电等行业优化;
如果不传此参数,则默认为camera。
支持多场景(scenes)一起检测,以分隔。例如,使用 scenes=web,camera 即对一张图片使用两个模型同时检测,输出两套识别结果。
detect-url
String
您可以通过填写 detect-url 处理任意公网可访问的图片链接。不填写 detect-url 时,后台会默认处理 ObjectKey ,填写了 detect-url 时,后台会处理 detect-url 链接,无需再填写 ObjectKey detect-url 示例:http://www.example.com/abc.jpg ,需要进行 UrlEncode,处理后为http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg

响应

响应包体具体数据内容如下:
参数名称
类型
描述
RecognitionResult
Container
图片标签识别结果
RecognitionResult 节点内容:
参数名称
类型
描述
WebLabels
Container
Web 网络版标签结果数组。
如未选择 web 场景,则不存在该项。此字段可能为空,表示取不到有效值。
CameraLabels
Container
Camera 摄像头版标签结果数组。
如未选择 camera 场景,则不存在该项。此字段可能为空,表示取不到有效值。
AlbumLabels
Container
Album 相册版标签结果数组。
如未选择 album 场景,则不存在该项。此字段可能为空,表示取不到有效值。
NewsLabels
Container
News 新闻版标签结果数组。
如未选择 news 场景,则不存在该项。此字段可能为空,表示取不到有效值。
WebLabels,CameraLabels,AlbumLabels,NewsLabels 节点内容:
参数名称
类型
描述
Labels
Container
标签信息
Labels节点内容:
参数名称
类型
描述
Confidence
Int
该标签的置信度分数,分数越高则该标签准确度越高
Name
String
识别出的图片标签
FirstCategory
String
标签的一级分类
SecondCategory
String
标签的二级分类

示例

请求

GET /picture.jpg?ci-process=detect-label&scenes=web,camera,album,news 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>
<AlbumLabels>
<Labels>
<Confidence>72</Confidence>
<FirstCategory>动植物</FirstCategory>
<Name>鹿</Name>
<SecondCategory>哺乳动物</SecondCategory>
</Labels>
</AlbumLabels>
<CameraLabels>
<Labels>
<Confidence>26</Confidence>
<FirstCategory>动植物</FirstCategory>
<Name>羚羊</Name>
<SecondCategory>哺乳动物</SecondCategory>
</Labels>
<Labels>
<Confidence>21</Confidence>
<FirstCategory>动植物</FirstCategory>
<Name>兔子</Name>
<SecondCategory>哺乳动物</SecondCategory>
</Labels>
<Labels>
<Confidence>18</Confidence>
<FirstCategory>动植物</FirstCategory>
<Name>鹿</Name>
<SecondCategory>哺乳动物</SecondCategory>
</Labels>
<Labels>
<Confidence>10</Confidence>
<FirstCategory>动植物</FirstCategory>
<Name>狮子</Name>
<SecondCategory>哺乳动物</SecondCategory>
</Labels>
<Labels>
<Confidence>5</Confidence>
<FirstCategory>动植物</FirstCategory>
<Name></Name>
<SecondCategory>哺乳动物</SecondCategory>
</Labels>
</CameraLabels>
<NewsLabels>
<Labels>
<Confidence>60</Confidence>
<FirstCategory>植物及其他生物</FirstCategory>
<Name>植物</Name>
<SecondCategory>植物类别</SecondCategory>
</Labels>
<Labels>
<Confidence>38</Confidence>
<FirstCategory>植物</FirstCategory>
<Name></Name>
<SecondCategory></SecondCategory>
</Labels>
</NewsLabels>
<WebLabels>
<Labels>
<Confidence>97</Confidence>
<FirstCategory>动植物</FirstCategory>
<Name>野生动物</Name>
<SecondCategory>其他</SecondCategory>
</Labels>
<Labels>
<Confidence>82</Confidence>
<FirstCategory>动植物</FirstCategory>
<Name>哺乳动物</Name>
<SecondCategory>哺乳动物</SecondCategory>
</Labels>
<Labels>
<Confidence>78</Confidence>
<FirstCategory>动植物</FirstCategory>
<Name>动物</Name>
<SecondCategory>其他</SecondCategory>
</Labels>
<Labels>
<Confidence>71</Confidence>
<FirstCategory>动植物</FirstCategory>
<Name>鹿</Name>
<SecondCategory>哺乳动物</SecondCategory>
</Labels>
<Labels>
<Confidence>41</Confidence>
<FirstCategory>动植物</FirstCategory>
<Name>白尾鹿</Name>
<SecondCategory>哺乳动物</SecondCategory>
</Labels>
</WebLabels>
</RecognitionResult>