对象存储图片标签-API 文档-文档中心-腾讯云

功能描述
图片标签功能通过借助对象存储的持久化处理接口，实现对 COS 存量数据的图片标签识别，返回图片中置信度较高的主题标签。
﻿
注意
本接口属于 GET 请求，为同步请求方式，需携带签名，具体签名设置请参见 请求签名。
授权说明
授权策略中 action 设置为 ci:CreateDetectLabelJob 。查看所有 action。
服务开通
使用该功能需提前开通数据万象，并绑定存储桶。详情请参见 绑定存储桶。
使用该功能需提前通过控制台或接口开通 AI 内容识别服务 。详情请参见 开通 AI 内容识别服务。
使用限制
使用该接口时，请先确认相关限制条件。详情请参见 使用限制。
费用说明
该接口为付费服务，产生的费用将由数据万象收取，详细计费说明可参见 内容识别费用。
请求语法
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>
﻿

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

图片标签

本页目录：

功能描述

授权说明

服务开通

使用限制

费用说明

请求语法

请求内容

返回内容

示例

请求

响应