功能概述
图片标签功能通过借助对象存储的持久化处理接口,实现对 COS 存量数据的图片标签识别,返回图片中置信度较高的主题标签。图片标签识别请求包属于 GET 请求,请求时需要携带签名。
注意:当前内容识别的图片限制为:图片格式支持 PNG、JPEG、JPG,图片大小不超过3MB,图片宽高大于50像素 x 50像素。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
请求语法
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>