本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。
智能媒体管理(IMM)中的图片标签检测功能能够识别图片中的场景、物体和事件等内容,从而实现图片的自动化标注。您可以按照以下步骤将图片标签检测从旧版(API版本为2017-09-06)迁移至新版(API版本为2020-09-30)。
背景信息
新增功能及优化将主要集中于新版,旧版将逐步下线。新版本相较于旧版提供了更广泛的地域支持,为了确保您获得更优质的使用体验,建议您尽快迁移至新版。
新版优势
响应速度:新版对图片的标签识别速度相对于旧版更快。
准确性:新版对图片的标签识别准确率相对于旧版更高。
灵活性:新版支持标签置信度过滤阈值,返回结果中不包含置信度低于该设定阈值的标签。
新版与旧版API对应关系说明
SDK/API版本
旧版使用旧版SDK,API版本为2017-09-06。
新版使用新版SDK,API版本为2020-09-30。
文档在线预览和协作编辑关于新版与旧版API的对应关系,请参见下表。
功能 | 新版API | 旧版API | 说明 |
功能 | 新版API | 旧版API | 说明 |
二维码识别 | DetectImageLabels - 检测图片中的标签信息 API版本为2020-09-30 | API版本为2017-09-06 | 新版支持标签置信度过滤阈值,返回结果不包含置信度小于该设定阈值的标签。 |
如何迁移
您可以按照以下步骤进行迁移:
创建新版项目。
调试新版同功能接口,并将您的业务切换至新版接口。
删除旧版本项目。
步骤一 :创建新版项目
创建新版项目之前确认是否已创建过新版项目,参考检查项目新旧版本,新版项目存在则无需创建。
控制台创建新版项目
登录智能媒体管理控制台。
左下角提供了新旧版本的切换功能,用户可在旧版中点击以体验新版。
在项目列表页面,请在页面左上角选择与旧版项目相同的地域,具体如下图所示。
在项目列表页面,单击创建项目,弹出创建项目面板,填写项目信息确认完成创建,如下图所示。
创建项目时,需选择与旧版项目相同的服务角色,并将工作流模板设置为Official:ImageManagement,其余选项无需进行配置。
步骤二:调用新版图片标签检测接口
标签检测迁移到新版
调用新版接口DetectImageLabels - 检测图片中的标签信息。具体操作请参见以下步骤:
DetectImageLabels图片标签检测接口的项目名参数应使用新版本创建的项目名称。
SDK/API版本
新版使用新版SDK,API版本为2020-09-30。
旧版使用旧版SDK,API版本为2017-09-06。
SDK 安装命令
pip install alibabacloud_imm20200930==4.6.1
示例代码:
# -*- coding: utf-8 -*- # This file is auto-generated, don't edit it. Thanks. import os import sys from typing import List from alibabacloud_imm20200930.client import Client as imm20200930Client from alibabacloud_tea_openapi import models as open_api_models from alibabacloud_imm20200930 import models as imm_20200930_models from alibabacloud_tea_util import models as util_models from alibabacloud_tea_util.client import Client as UtilClient class Sample: def __init__(self): pass @staticmethod def create_client() -> imm20200930Client: """ 使用AK&SK初始化账号Client @return: Client @throws Exception """ # 工程代码泄露可能会导致 AccessKey 泄露,并威胁账号下所有资源的安全性。以下代码示例仅供参考。 # 建议使用更安全的 STS 方式。 config = open_api_models.Config( # 必填,请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID。, access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'], # 必填,请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_SECRET。, access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET'] ) # Endpoint 请参考 https://api.aliyun.com/product/imm config.endpoint = f'imm.cn-hangzhou.aliyuncs.com' return imm20200930Client(config) @staticmethod def main( args: List[str], ) -> None: client = Sample.create_client() detect_image_labels_request = imm_20200930_models.DetectImageLabelsRequest( project_name='TestProject', source_uri='oss://test/labels.jpg' ) runtime = util_models.RuntimeOptions() try: # 复制代码运行请自行打印 API 的返回值 client.detect_image_labels_with_options(detect_image_labels_request, runtime) except Exception as error: # 此处仅做打印展示,请谨慎对待异常处理,在工程项目中切勿直接忽略异常。 # 错误 message print(error.message) # 诊断地址 print(error.data.get("Recommend")) UtilClient.assert_as_string(error.message) @staticmethod async def main_async( args: List[str], ) -> None: client = Sample.create_client() detect_image_labels_request = imm_20200930_models.DetectImageLabelsRequest( project_name='TestProject', source_uri='oss://test/labels.jpg' ) runtime = util_models.RuntimeOptions() try: # 复制代码运行请自行打印 API 的返回值 await client.detect_image_labels_with_options_async(detect_image_labels_request, runtime) except Exception as error: # 此处仅做打印展示,请谨慎对待异常处理,在工程项目中切勿直接忽略异常。 # 错误 message print(error.message) # 诊断地址 print(error.data.get("Recommend")) UtilClient.assert_as_string(error.message) if __name__ == '__main__': Sample.main(sys.argv[1:])
步骤三:删除旧版项目
删除旧版项目之前,请确保业务已完全迁移到新版,旧版没有流量之后再进行删除,此操作不可恢复。
登录智能媒体管理控制台。
左下角可切换新旧版本,点击可返回旧版。
在项目列表页面中,选择旧版项目所处的地域,如下图所示。
在项目列表页面中,选择需删除的旧版项目,然后点击删除按钮,如下图所示。
点击确定完成删除操作。
新旧版本图片标签检测计费
新旧版本的计费项和计费模式一致。
图片标签检测计费项
版本 | API | 计费 | 计费说明 |
版本 | API | 计费 | 计费说明 |
旧版标签检测 | API版本为2017-09-06 | 新旧版本的计费项和计费模式相同。 | |
新版标签检测 | DetectImageLabels - 检测图片中的标签信息 API版本为2020-09-30 |
- 本页导读 (1)
- 背景信息
- 新版优势
- 新版与旧版API对应关系说明
- 如何迁移
- 步骤一 :创建新版项目
- 步骤二:调用新版图片标签检测接口
- 步骤三:删除旧版项目
- 新旧版本图片标签检测计费
- 图片标签检测计费项