控制台指南

最佳实践

开发者指南

数据湖存储

API 文档

SDK 文档

文档捉虫大赛火热进行中,好礼多多> HOT

功能概述

图片标签功能通过借助对象存储的持久化处理接口,实现对 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>

目录