智能媒体管理(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版本为2020-09-30 |
说明
API版本为2017-09-06 |
新版支持标签置信度过滤阈值,返回结果不包含置信度小于该设定阈值的标签。 |
如何迁移
您可以按照以下步骤进行迁移:
-
创建新版项目。
-
调试新版同功能接口,并将您的业务切换至新版接口。
-
删除旧版本项目。
步骤一 :创建新版项目
创建新版项目之前确认是否已创建过新版项目,参考检查项目新旧版本,新版项目存在则无需创建。
控制台创建新版项目
-
登录智能媒体管理控制台。
-
左下角提供了新旧版本的切换功能,用户可在旧版中点击以体验新版。在概览页面左下角,单击体验新版按钮,切换到新版界面。
-
在项目列表页面,请在页面左上角选择与旧版项目相同的地域。
-
在项目列表页面,单击创建项目,弹出创建项目面板,填写项目信息确认完成创建,如下图所示。
说明创建项目时,需选择与旧版项目相同的服务角色,并将工作流模板设置为Official:ImageManagement,其余选项无需进行配置。
步骤二: 调用新版图片标签检测接口
标签检测迁移到新版
调用新版接口检测图片中的标签信息。具体操作请参见以下步骤:
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:])
步骤三:删除旧版项目
删除旧版项目之前,请确保业务已完全迁移到新版,旧版没有流量之后再进行删除,此操作不可恢复。
-
登录智能媒体管理控制台。
-
左下角可切换新旧版本,点击可返回旧版。
-
在项目列表页面中,选择旧版项目所处的地域。
地域选择器位于页面顶部导航栏,例如选择华北2(北京)。
-
在项目列表页面中,选择需删除的旧版项目,然后点击删除按钮。
-
点击确定完成删除操作。
新旧版本图片标签检测计费
新旧版本的计费项和计费模式一致。
图片标签检测计费项
|
版本 |
API |
计费 |
计费说明 |
|
旧版标签检测 |
说明
API版本为2017-09-06 |
新旧版本的计费项和计费模式相同。 |
|
|
新版标签检测 |
说明
API版本为2020-09-30 |