新舊版本使用指引
智能媒體管理（IMM）新版已經(jīng)正式開放，相比舊版，新版提供了更多更強(qiáng)大的能力。為了幫助您更好地使用我們的服務(wù)，本文將為您介紹新舊版本的區(qū)別對(duì)比以及最佳實(shí)踐。
新版優(yōu)勢(shì)
智能媒體管理（IMM）集成了更多實(shí)用能力，幫助您更好地分析、利用您存儲(chǔ)在阿里云對(duì)象存儲(chǔ)（OSS）、網(wǎng)盤與相冊(cè)服務(wù)（PDS）等媒體上的資源。
智能媒體管理（IMM）舊版計(jì)劃于2023年12月31日不再支持美國（硅谷）地域。
新增功能
更強(qiáng)大的數(shù)據(jù)處理能力
數(shù)據(jù)處理現(xiàn)已支持音視頻處理、文檔處理、圖片智能、音視頻智能、文件處理、內(nèi)容安全等。
更靈活的數(shù)據(jù)管理、數(shù)據(jù)查詢能力
媒體集（Set）升級(jí)為數(shù)據(jù)集（Dataset），支持全類型文件的元數(shù)據(jù)抽取以及元數(shù)據(jù)查詢。
全新的數(shù)據(jù)接入方式
提供綁定、觸發(fā)器、批處理等多種手段，接入對(duì)象存儲(chǔ)（OSS）以及網(wǎng)盤與相冊(cè)服務(wù)（PDS）等多種數(shù)據(jù)源。
更通用的任務(wù)管理與工作流支持
任務(wù)列表支持按時(shí)間、類型等進(jìn)行多維度篩選。工作流支持所有數(shù)據(jù)處理能力，按業(yè)務(wù)場景任意編排。
體驗(yàn)改善
全功能控制臺(tái)
提供全功能控制臺(tái)，通過控制臺(tái)使用智能媒體管理（IMM）的所有功能。
多語言SDK
提供8種主流語言SDK，通過SDK使用智能媒體管理（IMM）的所有功能。
多種計(jì)費(fèi)方式
除提供按量計(jì)費(fèi)的計(jì)費(fèi)方式外，新發(fā)布的數(shù)據(jù)處理資源包支持抵扣智能媒體管理（IMM）所有功能產(chǎn)生的費(fèi)用。
更高容量
提供更高的初始并發(fā)能力，支持更加彈性的方式使用智能媒體管理（IMM）的所有功能。
新版與舊版的關(guān)系
相互獨(dú)立使用
新版與舊版的項(xiàng)目、數(shù)據(jù)集（舊版稱為媒體集）均為完全獨(dú)立，相互不受任何干擾。例如：
控制臺(tái)界面，新舊版本可在控制臺(tái)切換，以管理對(duì)應(yīng)項(xiàng)目。
SDK/API版本。
舊版使用舊版SDK，API版本為2017-09-06。
新版使用新版SDK，API版本為2020-09-30。
新版與舊版API對(duì)應(yīng)關(guān)系說明
與舊版（2017-09-06版本）API相比，新版（2020-09-30版本）API新增了更多實(shí)用的功能接口，也刪除了部分接口，關(guān)于新版與舊版API的對(duì)應(yīng)關(guān)系，請(qǐng)參見下表。
功能 | 新版API | 舊版API | 說明 |
服務(wù)地域 | 無 | 新版可查詢支持智能媒體管理服務(wù)的Region（地域）列表信息，包括Region和對(duì)應(yīng)語言的描述信息。 | |
無 | 新版不再提供開通智能媒體管理服務(wù)的API接口，您可以通過智能媒體管理控制臺(tái)開通產(chǎn)品，操作更便捷。更多操作，請(qǐng)參見開通產(chǎn)品。 重要 如果您已通過舊版API開通智能媒體管理服務(wù)，切換新版后可直接使用，無需再次開通。 | ||
項(xiàng)目管理 | 新版項(xiàng)目創(chuàng)建支持設(shè)置工作流模板（Template）和配額。 | ||
數(shù)據(jù)集管理 | 新版數(shù)據(jù)集創(chuàng)建支持設(shè)置工作流模板（Template）和配額。
| ||
元數(shù)據(jù)索引 | 新版支持批量為數(shù)據(jù)集中的文件元信息建立索引。建立索引后，您可以進(jìn)行數(shù)據(jù)檢索、人臉聚類等操作。 | ||
無 | |||
新版支持獲取數(shù)據(jù)集中所有類型的文件信息。 | |||
無 | 新版支持批量獲取數(shù)據(jù)集中所有類型的文件信息。 | ||
新版支持刪除數(shù)據(jù)集中所有類型的文件。 | |||
無 | 新版支持批量刪除數(shù)據(jù)集中所有類型的文件。 | ||
新版支持更新?lián)袉蝹€(gè)或多個(gè)所有類型的文件列表。 | |||
無 | |||
查詢與統(tǒng)計(jì) | 新版支持對(duì)數(shù)據(jù)集中所有類型的文件進(jìn)行查詢和統(tǒng)計(jì)。查詢方式包括：
| ||
人臉聚類 | - | ||
新版支持將兩個(gè)以上的聚類分組進(jìn)行合并。 | |||
無 | 新版支持根據(jù)聚類分組的對(duì)象ID獲取單個(gè)聚類分組及其信息。 | ||
新版支持根據(jù)創(chuàng)建時(shí)間或更新時(shí)間查詢數(shù)據(jù)集中的聚類分組。 | |||
無 | 新版支持根據(jù)聚類分組的對(duì)象ID批量獲取聚類分組及其信息。 | ||
- | |||
無 | 新版支持搜索圖片中人物所在的聚類分組。 | ||
- | |||
時(shí)空聚類 | 無 | 新版支持基于數(shù)據(jù)集中照片的拍攝時(shí)間、地理位置等元數(shù)據(jù)信息創(chuàng)建時(shí)空聚類分組，并對(duì)聚類分組進(jìn)行查詢，更新和刪除操作。 | |
故事 | 無 | 新版支持將數(shù)據(jù)集中的照片按照時(shí)間、地點(diǎn)、人物、標(biāo)簽等多種維度來生成一組照片故事集。 | |
圖片聚類 | 無 | 新版支持將數(shù)據(jù)集內(nèi)的圖片根據(jù)相似度進(jìn)行分類并查詢，用于相似圖片（如連拍）去重、選優(yōu)等場景。 | |
數(shù)據(jù)綁定 | 無 | 新版支持為數(shù)據(jù)集和OSS Bucket創(chuàng)建綁定關(guān)系。綁定關(guān)系創(chuàng)建后，智能媒體管理服務(wù)會(huì)先對(duì)OSS Bucket中已有的數(shù)據(jù)進(jìn)行全量掃描，并抽取文件元數(shù)據(jù)信息進(jìn)行索引。完成后，繼續(xù)對(duì)OSS中新增的文件進(jìn)行實(shí)時(shí)的增量追蹤掃描、抽取以及索引。 | |
圖片處理 | - | ||
- | |||
新版支持條形碼檢測。 | |||
- | |||
DetectImageCropping - 通過AI模型能力在給定的目標(biāo)圖片比例下檢測出視覺效果較好的裁剪框區(qū)域 | - | ||
無 | 新版支持對(duì)一張圖片的特定區(qū)域進(jìn)行馬賽克、高斯模糊或純色塊填充操作，用于隱私保護(hù)。 | ||
無 | 新版支持將多張圖片轉(zhuǎn)換為單個(gè)PDF文件。 | ||
無 | 新版支持將多張圖片拼接為一張圖片。 | ||
- | |||
- | |||
無 | 新版支持檢測圖片中的車輛信息。 | ||
媒體處理 | CreateVideoCompressTask - 創(chuàng)建一個(gè)視頻壓縮存儲(chǔ)的任務(wù) | 新版支持對(duì)音視頻等文件進(jìn)行音頻提取、視頻加水印等操作。 | |
- | |||
CreateVideoLabelClassificationTask - 創(chuàng)建視頻標(biāo)簽檢測任務(wù) | 無 | 新版支持檢測視頻中的內(nèi)容所對(duì)應(yīng)的標(biāo)簽信息。 | |
文檔處理 | 新版文檔預(yù)覽效果更好。 | ||
- | |||
CreateOfficeConversionTask - 創(chuàng)建單個(gè)文檔的轉(zhuǎn)換任務(wù) | |||
無 | 新版支持提取文檔中的文本內(nèi)容。 | ||
文件處理 | 無 | 新版支持對(duì)文件進(jìn)行壓縮解壓、對(duì)點(diǎn)云文件進(jìn)行壓縮處理。 | |
內(nèi)容安全 | 無 | 新版支持對(duì)文本、圖片、視頻內(nèi)容進(jìn)行合規(guī)檢測，降低違規(guī)風(fēng)險(xiǎn)。 | |
任務(wù)管理 | 新版支持通過任務(wù)ID獲取所有異步任務(wù)的信息，包括任務(wù)開始時(shí)間、任務(wù)的運(yùn)行狀態(tài)、任務(wù)結(jié)束時(shí)間等。 | ||
ListOfficeConversionTask - 列出項(xiàng)目中已創(chuàng)建的文檔格式轉(zhuǎn)換任務(wù) | 新版支持根據(jù)任務(wù)運(yùn)行狀態(tài)、任務(wù)開始或結(jié)束的時(shí)間范圍獲取所有異步任務(wù)的相關(guān)信息。 | ||
無 | 新版支持創(chuàng)建觸發(fā)器，創(chuàng)建完成后，可通過OSS等事件源觸發(fā)IMM動(dòng)作，您可以選擇相應(yīng)的數(shù)據(jù)處理模板對(duì)圖片、視頻、文檔等媒體執(zhí)行相應(yīng)的處理。 | ||
無 | 新版支持創(chuàng)建批處理，創(chuàng)建完成后，您可以指定存儲(chǔ)內(nèi)已存在的若干文件，對(duì)其批量執(zhí)行指定操作，如轉(zhuǎn)碼、格式轉(zhuǎn)換等。 | ||
文檔轉(zhuǎn)換異步請(qǐng)求 | 無 | 新版任務(wù)開始執(zhí)行后，任務(wù)信息只保存7天，超過7天則無法再獲取。您可以通過多種方式及時(shí)獲取任務(wù)信息。具體操作，請(qǐng)參見各任務(wù)創(chuàng)建接口的接口說明。 | |
媒體集標(biāo)簽處理 | 無 | 您可以通過新版SimpleQuery - 簡單查詢接口統(tǒng)計(jì)數(shù)據(jù)集中的標(biāo)簽。 | |
圖片盲水印 | 新版在速度和抗攻擊能力方面顯著優(yōu)于舊版，并且具備向前兼容的特性，能夠解密舊版加密過的圖片。 | ||
計(jì)費(fèi)差異
新版計(jì)費(fèi)均為按使用量計(jì)費(fèi)，且可以購買資源包抵扣。更多信息，請(qǐng)參見計(jì)費(fèi)概述。
遷移到新版
為什么要遷移
智能媒體管理（IMM）后續(xù)新增功能、優(yōu)化均以新版為主，舊版將逐步下線。為了您有更好的使用體驗(yàn)，請(qǐng)盡快遷移到新版。
如何遷移
未使用媒體集功能
您可以按如下步驟遷移：
1、創(chuàng)建新版項(xiàng)目（通過新版控制臺(tái)、新版API均可）。
2、調(diào)試新版同功能對(duì)應(yīng)接口。
3、將您的業(yè)務(wù)切換到新版接口。
使用了媒體集功能
對(duì)于新增數(shù)據(jù)，您可以參考未使用媒體集功能處理。
對(duì)于存量數(shù)據(jù)，需要將媒體集（Set）內(nèi)的文件，通過重新索引到數(shù)據(jù)集（Dataset）內(nèi)，隨后使用數(shù)據(jù)集。
如果您需要幫助，可以聯(lián)系我們。
常見問題
舊版項(xiàng)目是否還可以正常使用？
可以，請(qǐng)注意切換控制臺(tái)版本。在調(diào)用接口時(shí)，確保您使用的SDK、API版本是正確的。
我們強(qiáng)烈建議您盡快遷移到新版項(xiàng)目。
為什么控制臺(tái)里無法找到我的項(xiàng)目？
請(qǐng)確認(rèn)您的控制臺(tái)是否為新版（或舊版），并檢查控制臺(tái)上方的地域是否為項(xiàng)目所在地域。
新舊版本是否可以混合使用？
可以，兩個(gè)版本項(xiàng)目完全獨(dú)立，分別計(jì)費(fèi)。我們強(qiáng)烈建議您盡快遷移到新版項(xiàng)目。