数据万象
文档捉虫大赛：人工智能与机器学习专题> HOT
文档中心 > 数据万象 > API 文档 > AI 内容识别 > 图片标签

图片标签

最近更新时间：2023-08-09 17:33:03

我的收藏

本页目录：

功能概述

图片标签功能通过借助数据万象的持久化处理接口，实现对 COS 存量数据的图片标签识别，返回图片中置信度较高的主题标签。图片标签识别请求包属于 GET 请求，请求时需要携带签名。
注意
当前内容识别的图片限制为：图片格式支持 PNG、JPEG、JPG，图片大小不超过3MB，图片宽高大于32 x 32像素，小于7680 x 4320像素。


请求语法

原图存储在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>

中国站