如何检测图片标签_对象存储(OSS)-阿里云帮助中心

您可以使用图片标签检测来识别图片中的场景、物体和事件等标签信息，实现图片的自动打标。本文主要介绍图片标签算子的功能参数和示例。

使用场景

场景名称	场景说明
内容识别	根据拍摄或上传的图片，识别图片中的物品、场景等信息，可应用于拍照识物或科普类的功能或产品中。
智能相册	根据图片内容信息，并对图片进行自动分类，实现相册图库的智能分类，实现高效自动化管理。
场景分析	对图片中包含的多种事物或场景进行识别，为不同场景打上内容标签，提升场景分析效率，减少人工标注成本。
内容运营	获取图片标签信息，实现内容推荐，可广泛应用于社交或新闻资讯及电商等内容平台中。

注意事项

图片标签检测仅支持同步处理（x-oss-process处理方式）。
使用图片标签检测功能前，需要先绑定IMM Project。关于控制台和API如何绑定，请参见快速入门和AttachOSSBucket。
不支持匿名访问。
必须拥有IMM处理所需的相关权限。更多信息，请参见权限。

参数说明

操作名称：image/labels

请求参数

参数名称	类型	是否必须	描述	示例值
thr	int	否	小于设定阈值的标签不被显示。取值范围为[0, 100]（默认值为70）。	50

返回参数

说明

具体返回参数，请参见 DetectImageLabels - 检测图片中的标签信息。

使用REST API

不设定过滤阈值情况下获取标签

阈值设定

不设定

处理示例

GET /example.jpg?x-oss-process=image/labels HTTP/1.1
Host: image-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 21 Jul 2023 08:30:25 GMT
Authorization: OSS qn6qrrqxo2oawuk53otf****:UNQDb7GapEgJkcde6OhZ9J****

返回示例

HTTP/1.1 200 OK
Server: AliyunOSS
Date: Fri, 21 Jul 2023 08:30:26 GMT
Content-Type: application/json;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Vary: Accept-Encoding
x-oss-request-id: 64BA42225DFDD13437ECD00E
Last-Modified: Mon, 10 Jul 2023 13:07:30 GMT
x-oss-object-type: Normal
x-oss-hash-crc64ecma: 13420962247653419692
x-oss-storage-class: Standard
x-oss-ec: 0048-00000104
Content-Disposition: attachment
x-oss-force-download: true
x-oss-server-time: 489
Content-Encoding: gzip

{
    "Labels":[
        {
            "CentricScore": 0.823,
            "LabelConfidence": 1.0,
            "LabelLevel": 2,
            "LabelName": "外套",
            "Language": "zh-Hans",
            "ParentLabelName": "衣服"
        },
        { 
            "CentricScore": 0.721,
            "LabelConfidence": 0.735,
            "LabelLevel": 2,
            "LabelName": "服装",
            "Language": "zh-Hans",
            "ParentLabelName": "衣服"
        },
    		......,
    ],
    "RequestId": "0EC0B6EC-EB16-5EF4-812B-EF3A60C7D20D"
}

设定过滤阈值情况下获取标签

阈值设定

thr: 85

处理示例

GET /example.jpg?x-oss-process=image/labels,thr_85 HTTP/1.1
Host: image-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 21 Jul 2023 08:44:58 GMT
Authorization: OSS qn6qrrqxo2oawuk53otf****:UNQDb7GapEgJkcde6OhZ9J****

返回示例

HTTP/1.1 200 OK
Server: AliyunOSS
Date: Fri, 21 Jul 2023 08:45:00 GMT
Content-Type: application/json;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Vary: Accept-Encoding
x-oss-request-id: 64BA458C7FFDC2383651DF09
Last-Modified: Mon, 10 Jul 2023 13:07:30 GMT
x-oss-object-type: Normal
x-oss-hash-crc64ecma: 13420962247653419692
x-oss-storage-class: Standard
x-oss-ec: 0048-00000104
Content-Disposition: attachment
x-oss-force-download: true
x-oss-server-time: 421
Content-Encoding: gzip

{
  "RequestId": "B7BDAFD5-C0AF-5042-A749-88BF6E4F2712", 
  "Labels": [
     {
      	"CentricScore": 0.797,
      	"Language": "zh-Hans",
      	"LabelConfidence": 0.927,
      	"LabelName": "服装",
      	"LabelLevel": 2,
      	"ParentLabelName": "衣服"
      },
        ......,
   ]
}

使用SDK

图片标签检测仅支持同步处理，SDK使用方法请参见使用SDK。