简介
本文档提供关于图片标签的相关 API 概览以及 SDK 示例代码。
API | 操作描述 |
图片标签 |
图片标签
功能说明
图片标签功能通过借助数据万象的持久化处理接口，实现对 COS 存量数据的图片标签识别，返回图片中置信度较高的主题标签。图片标签识别请求包属于 GET 请求，请求时需要携带签名。
示例代码
def ci_image_detect_label():# 图片标签# demo地址：https://github.com/tencentyun/cos-python-sdk-v5/blob/master/demo/ci_image.py#L586response = client.ci_image_detect_label(Bucket=bucket_name, Key='test.jpg', Scenes='camera',# DetectUrl='https://test-125000000.cos.ap-chongqing.myqcloud.com/test.jpeg',)print(response)return response
参数说明
调用 cos_detect_label 函数，具体请求参数如下：
参数名称 | 参数描述 | 类型 | 是否必填 |
Bucket | 存储桶名称 | String | 是 |
Key | 设置对象名称。Key与DetectUrl必选一个 | String | 否 |
Scenes | 本次调用支持的识别场景，可选值如下： web，针对网络图片优化； camera，针对手机摄像头拍摄图片优化； album，针对手机相册、网盘产品优化； news，针对新闻、资讯、广电等行业优化； 如果不传此参数，则默认为 camera。 支持多场景（scenes）一起检测，以，分隔。例如，使用 scenes=web，camera 即对一张图片使用两个模型同时检测，输出两套识别结果 | String | 否 |
DetectUrl | 您可以通过填写 detect-url 处理任意公网可访问的图片链接。不填写 detect-url 时，后台会默认处理 ObjectKey ，填写了 detect-url 时，后台会处理 detect-url 链接，无需再填写 ObjectKey。detect-url 示例： http://www.example.com/abc.jpg。Key与DetectUrl必选一个 | String | 否 |
返回结果说明
response 为响应头，data 为图片标签结果，数据类型都为 dict。
response内容
响应体data
由于接口默认返回xml内容，解析结果都为string类型，以下描述为字段的真实类型。具体数据内容如下：
参数名称 | 参数描述 | 类型 |
WebLabels | Web 网络版标签结果数组。如未选择 web 场景，则不存在该项。此字段可能为空，表示取不到有效值 | Container |
CameraLabels | Camera 摄像头版标签结果数组。如未选择 camera 场景，则不存在该项。此字段可能为空，表示取不到有效值 | Container |
AlbumLabels | Album 相册版标签结果数组。如未选择 album 场景，则不存在该项。此字段可能为空，表示取不到有效值 | Container |
NewsLabels | News 新闻版标签结果数组。如未选择 news 场景，则不存在该项。此字段可能为空，表示取不到有效值 | Container |
WebLabels，CameraLabels，AlbumLabels，NewsLabels 节点内容：
参数名称 | 参数描述 | 类型 |
Labels | 标签信息 | Container Array |
Labels节点内容：
参数名称 | 参数描述 | 类型 |
Confidence | 该标签的置信度分数，分数越高则该标签准确度越高 | Integer |
Name | 识别出的图片标签 | String |
FirstCategory | 标签的一级分类 | String |
SecondCategory | 标签的二级分类 | String |
