新旧版本使用指引

智能媒体管理(IMM)新版已经正式开放,相比旧版,新版提供了更多更强大的能力。为了帮助您更好地使用我们的服务,本文将为您介绍新旧版本的区别对比以及最佳实践。

新版优势

智能媒体管理(IMM)集成了更多实用能力,帮助您更好地分析、利用您存储在阿里云对象存储(OSS)、网盘与相册服务(PDS)等媒体上的资源。

重要

智能媒体管理(IMM)旧版计划于2023年12月31日不再支持美国(硅谷)地域。

新增功能

更强大的数据处理能力

数据处理现已支持音视频处理、文档处理、图片智能、音视频智能、文件处理、内容安全等。

更灵活的数据管理、数据查询能力

媒体集(Set)升级为数据集(Dataset),支持全类型文件的元数据抽取以及元数据查询。

全新的数据接入方式

提供绑定、触发器、批处理等多种手段,接入对象存储(OSS)以及网盘与相册服务(PDS)等多种数据源。

更通用的任务管理与工作流支持

任务列表支持按时间、类型等进行多维度筛选。工作流支持所有数据处理能力,按业务场景任意编排。

体验改善

全功能控制台

提供全功能控制台,通过控制台使用智能媒体管理(IMM)的所有功能。

多语言SDK

提供8种主流语言SDK,通过SDK使用智能媒体管理(IMM)的所有功能。

多种计费方式

除提供按量计费的计费方式外,新发布的数据处理资源包支持抵扣智能媒体管理(IMM)所有功能产生的费用。

更高容量

提供更高的初始并发能力,支持更加弹性的方式使用智能媒体管理(IMM)的所有功能。

新版与旧版的关系

相互独立使用

新版与旧版的项目、数据集(旧版称为媒体集)均为完全独立,相互不受任何干扰。例如:

  • 控制台界面,新旧版本可在控制台切换,以管理对应项目。

  • SDK/API版本。

    • 旧版使用旧版SDK,API版本为2017-09-06。

    • 新版使用新版SDK,API版本为2020-09-30。

新版与旧版API对应关系说明

与旧版(2017-09-06版本)API相比,新版(2020-09-30版本)API新增了更多实用的功能接口,也删除了部分接口,关于新版与旧版API的对应关系,请参见下表。

功能

新版API

旧版API

说明

服务地域

ListRegions - 查询支持IMM服务的Region列表

新版可查询支持智能媒体管理服务的Region(地域)列表信息,包括Region和对应语言的描述信息。

OpenImmService - 开通智能媒体管理服务

新版不再提供开通智能媒体管理服务的API接口,您可以通过智能媒体管理控制台开通产品,操作更便捷。更多操作,请参见开通产品

重要

如果您已通过旧版API开通智能媒体管理服务,切换新版后可直接使用,无需再次开通。

项目管理

CreateProject - 创建项目

PutProject - 创建一个项目

新版项目创建支持设置工作流模板(Template)和配额。

  • 工作流模板定义了提取文件元信息时所需要执行的工作流。更多信息,请参见工作流模板与算子

  • 项目配额包括单用户可创建项目最大数量、项目中数据集的最大个数等。更多信息,请参见限额配置

GetProject - 获取项目信息

GetProject - 获取项目的信息

UpdateProject - 更新项目

UpdateProject - 更新项目的CU或服务角色信息

ListProjects - 列出所有项目信息的列表

ListProjects - 列出已创建的所有项目信息

DeleteProject - 删除项目

DeleteProject - 删除一个项目

数据集管理

CreateDataset - 创建数据集

CreateSet - 创建媒体集

新版数据集创建支持设置工作流模板(Template)和配额。

  • 数据集的工作流模板优先级高于项目设置的工作流模板。当数据集工作流模板为空时,则使用项目设置的工作流模板。

  • 数据集配额包括每个数据集可绑定的OSS Bucket最大个数、每个数据集中文件的最大个数等。更多信息,请参见限额配置

UpdateDataset - 更新数据集

UpdateSet - 更新媒体集的显示名称

GetDataset - 查询数据集信息

GetSet - 获取媒体集信息

ListDatasets - 列出数据集

ListSets - 获取媒体集列表

DeleteDataset - 删除数据集

DeleteSet - 删除媒体集

元数据索引

IndexFileMeta - 文件元信息建立索引

IndexImage - 将图片加入媒体集

新版支持批量为数据集中的文件元信息建立索引。建立索引后,您可以进行数据检索、人脸聚类等操作。

IndexVideo - 对视频进行自动截帧、分组、识别操作

BatchIndexFileMeta - 批量文件元信息建立索引

GetFileMeta - 获取文件元数据

GetImage - 从媒体集中获取一张图片的信息

新版支持获取数据集中所有类型的文件信息。

GetVideo - 获取一个视频的信息

BatchGetFileMeta - 批量获取文件元数据

新版支持批量获取数据集中所有类型的文件信息。

DeleteFileMeta - 删除文件元信息

DeleteImage - 删除图片

新版支持删除数据集中所有类型的文件。

DeleteVideo - 删除一个视频的信息

BatchDeleteFileMeta - 批量删除文件元信息

新版支持批量删除数据集中所有类型的文件。

UpdateFileMeta - 更新文件元数据

UpdateImage - 更新媒体集中用户自定义的图片信息

新版支持更新据集中单个或多个所有类型的文件列表。

BatchUpdateFileMeta - 批量更新文件元信息

查询与统计

查询与统计

FindImages - 搜索媒体集中图片

新版支持对数据集中所有类型的文件进行查询和统计。查询方式包括:

  • 通过逻辑关系表达式进行简单查询。

  • 通过输入自然语言关键字进行查询。

  • 通过输入关键词进行模糊查询。

ListImages - 获取媒体集中的图片列表

ListVideos - 获取多个视频的信息

人脸聚类

CreateFigureClusteringTask - 创建人物聚类任务

CreateGroupFacesJob - 人脸聚类

-

CreateFigureClustersMergingTask - 合并人物聚类

CreateMergeFaceGroupsJob - 合并媒体集中的两个人脸分组

新版支持将两个以上的聚类分组进行合并。

GetFigureCluster - 获取人物聚类信息

新版支持根据聚类分组的对象ID获取单个聚类分组及其信息。

QueryFigureClusters - 查询人物聚类

ListFaceGroups - 获取一个媒体集中的人脸分组列表

新版支持根据创建时间或更新时间查询数据集中的聚类分组。

BatchGetFigureCluster - 批量获取人脸聚类

新版支持根据聚类分组的对象ID批量获取聚类分组及其信息。

UpdateFigureCluster - 更新人物聚类

UpdateFaceGroup - 更新媒体集中人脸分组

-

SearchImageFigureCluster - 查询图片人脸所属聚类

新版支持搜索图片中人物所在的聚类分组。

CreateFacesSearchingTask - 创建相似人脸图片检索任务

FindSimilarFaces - 查找和指定人脸相似的人脸

-

时空聚类

时空聚类

新版支持基于数据集中照片的拍摄时间、地理位置等元数据信息创建时空聚类分组,并对聚类分组进行查询,更新和删除操作。

故事

故事

新版支持将数据集中的照片按照时间、地点、人物、标签等多种维度来生成一组照片故事集。

图片聚类

图片聚类

新版支持将数据集内的图片根据相似度进行分类并查询,用于相似图片(如连拍)去重、选优等场景。

数据绑定

数据绑定

新版支持为数据集和OSS Bucket创建绑定关系。绑定关系创建后,智能媒体管理服务会先对OSS Bucket中已有的数据进行全量扫描,并抽取文件元数据信息进行索引。完成后,继续对OSS中新增的文件进行实时的增量追踪扫描、抽取以及索引。

图片处理

DetectImageLabels - 检测图片中的标签信息

DetectImageTags - 检测图片中的标签场景

-

DetectImageScore - 获取图片分数

GetImageQuality - 获取图片综合质量分数

-

DetectImageCodes - 图片二维码检测

DetectQRCodes - 二维码检测

新版支持条形码检测。

DetectImageQRCodes - 检测图片中二维码

DetectImageFaces - 通过AI模型能力检测图片中的人脸以及人脸信息

DetectImageFaces - 检测图片中的人脸及人脸信息

-

DetectImageCropping - 通过AI模型能力在给定的目标图片比例下检测出视觉效果较好的裁剪框区域

GetImageCroppingSuggestions - 获取图片裁剪建议(裁剪框位置)

-

AddImageMosaic - 添加图片马赛克

新版支持对一张图片的特定区域进行马赛克、高斯模糊或纯色块填充操作,用于隐私保护。

CreateImageToPDFTask - 创建图片转PDF任务

新版支持将多张图片转换为单个PDF文件。

CreateImageSplicingTask - 创建图片拼接任务

新版支持将多张图片拼接为一张图片。

CompareImageFaces - 图片人脸相似度比对

CompareImageFaces - 比较两个人脸的相似度

-

DetectImageBodies - 检测图片中的人体

DetectImageBodies - 检测图片中的人体

-

DetectImageCars - 检测图片中的车辆信息

新版支持检测图片中的车辆信息。

媒体处理

CreateMediaConvertTask - 创建媒体转码任务

CreateVideoCompressTask - 创建一个视频压缩存储的任务

新版支持对音视频等文件进行音频提取、视频加水印等操作。

CreateGrabFrameTask - 创建一个视频截帧任务

DetectMediaMeta - 获取媒体文件元信息

GetMediaMeta - 获取多媒体文件信息

-

CreateVideoLabelClassificationTask - 创建视频标签检测任务

新版支持检测视频中的内容所对应的标签信息。

GetVideoLabelClassificationResult - 获取视频标签检测任务

文档处理

GenerateWebofficeToken - 获取Weboffice凭证

GetOfficePreviewURL - 获取文档预览URL

新版文档预览效果更好。

GetWebofficeURL - 获取Weboffice的访问凭证

RefreshWebofficeToken - 刷新Weboffice凭证

RefreshOfficePreviewToken - 刷新文档预览凭证

RefreshWebofficeToken - 刷新Weboffice的访问凭证

CreateOfficeConversionTask - 创建文档转换任务

ConvertOfficeFormat - 文档(例如OFFICE文档)格式的转换

-

CreateOfficeConversionTask - 创建单个文档的转换任务

ExtractDocumentText - 文档正文提取

新版支持提取文档中的文本内容。

文件处理

压缩解压

新版支持对文件进行压缩解压、对点云文件进行压缩处理。

点云压缩

内容安全

内容安全

新版支持对文本、图片、视频内容进行合规检测,降低违规风险。

任务管理

GetTask - 获取任务信息

GetOfficeConversionTask - 查询异步文档格式转换任务的状态信息

新版支持通过任务ID获取所有异步任务的信息,包括任务开始时间、任务的运行状态、任务结束时间等。

GetVideoTask - 查询视频类任务

ListTasks - 列出任务

ListOfficeConversionTask - 列出项目中已创建的文档格式转换任务

新版支持根据任务运行状态、任务开始或结束的时间范围获取所有异步任务的相关信息。

ListVideoTasks - 列出视频类异步任务

触发器

新版支持创建触发器,创建完成后,可通过OSS等事件源触发IMM动作,您可以选择相应的数据处理模板对图片、视频、文档等媒体执行相应的处理。

批处理

新版支持创建批处理,创建完成后,您可以指定存储内已存在的若干文件,对其批量执行指定操作,如转码、格式转换等。

文档转换异步请求

DeleteOfficeConversionTask - 删除异步文档格式转换任务

新版任务开始执行后,任务信息只保存7天,超过7天则无法再获取。您可以通过多种方式及时获取任务信息。具体操作,请参见各任务创建接口的接口说明。

DeleteVideoTask - 删除视频异步任务

媒体集标签处理

ListSetTags - 统计媒体集内标签

您可以通过新版SimpleQuery - 简单查询接口统计数据集中的标签。

图片盲水印

EncodeBlindWatermark - 添加图片盲水印

EncodeBlindWatermark - 添加图片盲水印

新版在速度和抗攻击能力方面显著优于旧版,并且具备向前兼容的特性,能够解密旧版加密过的图片。

CreateDecodeBlindWatermarkTask - 创建解析盲水印任务

DecodeBlindWatermark - 解析图片盲水印

计费差异

新版计费均为按使用量计费,且可以购买资源包抵扣。更多信息,请参见计费概述

迁移到新版

为什么要迁移

智能媒体管理(IMM)后续新增功能、优化均以新版为主,旧版将逐步下线。为了您有更好的使用体验,请尽快迁移到新版。

如何迁移

未使用媒体集功能

您可以按如下步骤迁移:

1、创建新版项目(通过新版控制台、新版API均可)。

2、调试新版同功能对应接口。

3、将您的业务切换到新版接口。

使用了媒体集功能

  • 对于新增数据,您可以参考未使用媒体集功能处理。

  • 对于存量数据,需要将媒体集(Set)内的文件,通过重新索引到数据集(Dataset)内,随后使用数据集。

  • 如果您需要帮助,可以联系我们

常见问题

旧版项目是否还可以正常使用?

可以,请注意切换控制台版本。在调用接口时,确保您使用的SDK、API版本是正确的。

我们强烈建议您尽快迁移到新版项目。

为什么控制台里无法找到我的项目?

请确认您的控制台是否为新版(或旧版),并检查控制台上方的地域是否为项目所在地域。

新旧版本是否可以混合使用?

可以,两个版本项目完全独立,分别计费。我们强烈建议您尽快迁移到新版项目。

联系我们

联系我们