工作流程範本與運算元

本文介紹Intelligent Media ManagementIMM提供的工作流程範本ID（TemplateId）及其對應支援的運算元。

簡介

在建立IMM專案或資料集時，可以為專案或資料集設定工作流程範本（Template），模板定義了部分介面所需要執行的工作流程。在為儲存在Object Storage Service、相簿與網盤服務（PDS）等產品中的檔案建立中繼資料索引時，引擎將根據配置的工作流程範本來決定要執行的運算元操作，運算元對中繼資料進行採集並將中繼資料索引到中繼資料存放區引擎中。

注意事項

在通過綁定OSS Bucket或調用IndexFileMeta - 索引檔案元資訊、BatchIndexFileMeta - 批量索引檔案元資訊介面建立中繼資料索引時，根據資料集和專案配置的工作流程範本來決定要執行的運算元操作。
在資料集中建立中繼資料索引時，資料集的模板優先順序高於專案設定的模板。當資料集模板為空白時，則使用專案設定的模板。
工作流程範本不會對使用者主動使用其他API（例如視頻轉碼、圖片臉部偵測、圖片打分、人臉聚類等）產生限制，但可能因為索引中不存在對應中繼資料，實際不產生效果。
建立索引過程會產生運算元計費和索引儲存費用。費用詳情請參見計費項目。

工作流程範本

IMM提供的工作流程範本如下表所示。

TemplateId	說明

TemplateId	說明
Official:DefaultEmptyId	空模板。在建立中繼資料索引時，所有運算元都不操作，不會產生中繼資料資訊。
Official:OSSBasicMeta	OSS基本中繼資料模板。在建立中繼資料索引時，執行OSSMeta運算元，採集OSS基本中繼資料。
Official:AllFunction	全功能模板（僅供測試）。在建立中繼資料索引時，執行所有運算元，採集OSS基本中繼資料、MIME資訊、人臉資訊、標籤檢測、圖片打分、地址位置資訊、視頻資訊、圖片EXIF資訊、辦公文檔本文內容等資料。重要該模板包含IMM提供的全部能力。僅供測試使用，IMM會根據功能上線情況隨時增減該模板運算元，因此可能引起計費項目增減，請在使用時注意。如果您有特定功能需求，請選擇其他模板。
Official:FaceManagement	Face Service模板。在建立中繼資料索引時，對圖片類檔案的人臉進行檢測和索引。可配合人臉聚類相關介面實現人物相簿，或配合人臉搜尋介面實現門禁、考勤打卡能力。
Official:ImageManagement	圖片系統管理範本。在建立中繼資料索引時，對圖片進行分析，擷取其尺寸、拍攝位置、人臉、標籤等資訊，用於構建全功能智能相簿。
Official:CognitionImageManagement	圖片語義搜尋模板。在建立中繼資料索引時，除對圖片進行分析，擷取其尺寸、拍攝位置、人臉、標籤等資訊外，增加對圖片的理解能力。配合 SemanticQuery - 自然語言查詢介面的語義搜尋功能，提供更加準確優質的圖片內容檢索能力。協助您構建大模型時代智能相簿。重要該模板目前僅在北京地區支援，且目前處於免費邀測狀態。若您希望使用，請聯絡您的客戶經理或通過工單聯絡我們。
Official:DocumentManagement	文檔全文檢索索引模板。在建立中繼資料索引時，提取文檔類檔案的文本並進行索引。配合搜尋介面實現文檔的全文檢索索引能力。
Official:MediaMeta	媒體資訊系統管理範本。在建立中繼資料索引時，提取圖片、視頻等檔案的多媒體資訊，如尺寸、拍攝時間、地點、時間長度、編碼格式等。可用於媒體檔案的分類管理、統計等情境。
Official:CognitionDocumentManagement	文檔語義搜尋模板。在建立中繼資料索引時，通過大模型能力，對文檔內的文本進行分析和理解。配合 SemanticQuery - 自然語言查詢介面的語義搜尋功能，實現基於語義的智能文檔檢索。重要該模板目前僅在北京地區支援，且目前處於免費邀測狀態。若您希望使用，請聯絡您的客戶經理或通過工單聯絡我們。

運算元

IMM支援的運算元如下表所示。

警告

使用運算元可能產生對應計費項目，詳情請參考：運算元與計費項目對應關係。

運算元	說明

運算元	說明
OSSMeta運算元	產生OSS檔案的檔案名稱、檔案類型、檔案大小、檔案HASH、檔案修改時間、ETag、標籤等資料。
MIME運算元	產生MIME資料。
FaceDetection運算元	產生人臉資訊資料。
LabelClassification運算元（圖片）	產生圖片標籤資訊資料。
LabelClassification運算元（視頻）	產生視頻標籤資訊資料。
ImageScoring運算元	產生圖片打分資料。
ExtractImageEmbeddings運算元	產生圖片特徵資訊資料。
ReGEO運算元	產生地址位置資訊資料。
MediaMeta運算元	產生視頻資訊資料。
EXIF運算元	產生圖片EXIF資訊資料。
ExtractDocumentText運算元	產生辦公文檔資訊資料。

工作流程範本與運算元的對應關係

IMM提供的TemplateId及其對應的運算元如下表所示，其中支援表示在建立中繼資料索引時會執行該運算元操作，不支援表示在建立中繼資料索引時不會執行該運算元操作。

TemplateId	運算元
TemplateId	OSSMeta（OSS 元資訊）	MIME （檔案類型）	FaceDetection （臉部偵測）	LabelClassification運算元（標籤檢測）	ImageScoring （圖片打分）	ExtractImageEmbeddings （圖片特徵提取）	ReGEO （地理位置）	MediaMeta （視頻資訊）	EXIF （圖片資訊）	ExtractDocumentText （文檔資訊）

TemplateId	運算元
TemplateId	OSSMeta（OSS 元資訊）	MIME （檔案類型）	FaceDetection （臉部偵測）	LabelClassification運算元（標籤檢測）	ImageScoring （圖片打分）	ExtractImageEmbeddings （圖片特徵提取）	ReGEO （地理位置）	MediaMeta （視頻資訊）	EXIF （圖片資訊）	ExtractDocumentText （文檔資訊）
Official:DefaultEmptyId	不支援	不支援	不支援	不支援	不支援	不支援	不支援	不支援	不支援	不支援
Official:OSSBasicMeta	支援	不支援	不支援	不支援	不支援	不支援	不支援	不支援	不支援	不支援
Official:AllFunction	支援	支援	支援（包括視頻檔案和圖片檔案）	支援（包括視頻檔案和圖片檔案）	支援	不支援	支援	支援	支援	支援
Official:FaceManagement	支援	不支援	支援（包括視頻檔案和圖片檔案）	不支援	不支援	不支援	不支援	不支援	不支援	不支援
Official:ImageManagement	支援	支援	支援	支援	支援	不支援	支援	不支援	支援	不支援
Official:CognitionImageManagement	支援	支援	支援	支援	支援	支援	支援	不支援	支援	不支援
Official:DocumentManagement	支援	支援	不支援	不支援	不支援	不支援	不支援	不支援	不支援	支援
Official:MediaMeta	支援	支援	不支援	不支援	不支援	不支援	支援	支援	支援	不支援
Official:CognitionDocumentManagement	支援	支援	不支援	不支援	不支援	不支援	不支援	不支援	不支援	不支援

工作流程範本使用樣本

如下以使用全功能模板（Official:AllFunction）建立圖片中繼資料索引為例，介紹如何使用工作流程範本。

調用CreateDataset - 建立資料集介面在IMM專案test-project下使用Official:AllFunction模板，建立名稱為allfunction的資料集。具體操作，請參見建立資料集。

請求樣本

{
 "ProjectName": "test-project",
 "DatasetName": "allfunction",
 "Description": "全功能模板資料集",
 "TemplateId": "Official:AllFunction"
}

返回樣本

{
    "RequestId": "9AB4BD43-C4E5-06AA-A8AB-****",
    "Dataset": {
        "FileCount": 0,
        "BindCount": 0,
        "ProjectName": "test-project",
        "CreateTime": "2022-07-08T10:43:32.429344821+08:00",
        "DatasetMaxTotalFileSize": 90000000000000000,
        "DatasetMaxRelationCount": 100000000000,
        "DatasetMaxFileCount": 100000000,
        "DatasetName": "allfunction",
        "DatasetMaxBindCount": 10,
        "UpdateTime": "2022-07-08T10:43:32.429344821+08:00",
        "DatasetMaxEntityCount": 10000000000,
        "TotalFileSize": 0,
        "TemplateId": "Official:AllFunction"
    }
}

調用IndexFileMeta - 索引檔案元資訊介面為OSS檔案oss://test-bucket/test-object.jpg建立中繼資料索引。具體操作，請參見建立中繼資料索引。

請求樣本

{
  "ProjectName": "test-project",
  "DatasetName": "allfunction",
  "File": {
    "URI": "oss://test-bucket/test-object.jpg",
    "CustomLabels": {
      "category": "人物"
    }
  },
  "Notification": {
    "MNS": {
      "TopicName": "test-topic"
    }
  }
}

返回樣本

{
    "RequestId": "5AA694AD-3D10-0B6A-86B4-****",
    "EventId": "17C-1Kofq1mlJxRYF7vNGF****"
}

調用GetFileMeta - 擷取檔案中繼資料介面查詢OSS檔案oss://test-bucket/test-object.jpg的中繼資料資訊。具體操作，請參見查詢檔案資訊。

請求樣本

{
    "ProjectName": "test-project",
    "URI": "oss://test-bucket/test-object.jpg",
    "DatasetName": "allfunction"
}

返回樣本

{
    "RequestId": "F79E92D5-FA41-0AD6-8948-****",
    "Files": [
        {
            "ProduceTime": "2020-08-19T17:11:11+08:00",
            "ObjectACL": "default",
            "ContentType": "image/jpeg",
            "ProjectName": "test-project",
            "Size": 22868,
            "URI": "oss://test-bucket/test-object.jpg",
            "Addresses": [
                {
                    "Language": "zh-Hans",
                    "Township": "塘溝鎮",
                    "AddressLine": "江蘇省宿遷市沭陽縣塘溝鎮陳龍莊",
                    "Country": "中國",
                    "City": "宿遷市",
                    "District": "沭陽縣",
                    "Province": "江蘇省"
                }
            ],
            "ObjectType": "file",
            "CustomLabels": {
                "category": "照片"
            },
            "OwnerId": "****",
            "FileModifiedTime": "2021-05-13T10:22:44+08:00",
            "ImageWidth": 270,
            "OSSStorageClass": "Standard",
            "MediaType": "image",
            "ObjectId": "75d5de2c50754e3dadd5c35dbca5f9949369e****",
            "CreateTime": "2022-07-08T14:34:01.400716231+08:00",
            "Filename": "1.jpg",
            "Labels": [
                {
                    "CentricScore": 0.859000027179718,
                    "Language": "zh-Hans",
                    "LabelConfidence": 1,
                    "LabelName": "女士",
                    "LabelLevel": 2,
                    "ParentLabelName": "面部"
                },
                {
                    "CentricScore": 0.7770000100135803,
                    "Language": "zh-Hans",
                    "LabelConfidence": 1,
                    "LabelName": "服裝",
                    "LabelLevel": 2,
                    "ParentLabelName": "衣服"
                },
                {
                    "CentricScore": 0.8809999823570251,
                    "Language": "zh-Hans",
                    "LabelConfidence": 1,
                    "LabelName": "長發",
                    "LabelLevel": 2,
                    "ParentLabelName": "外貌特徵"
                },
                {
                    "CentricScore": 0.8899999856948853,
                    "Language": "zh-Hans",
                    "LabelConfidence": 1,
                    "LabelName": "黑髮",
                    "LabelLevel": 2,
                    "ParentLabelName": "外貌特徵"
                },
                {
                    "CentricScore": 0.8330000042915344,
                    "Language": "zh-Hans",
                    "LabelConfidence": 1,
                    "LabelName": "肖像攝影",
                    "LabelLevel": 2,
                    "ParentLabelName": "藝術品"
                },
                {
                    "CentricScore": 0.8299999833106995,
                    "Language": "zh-Hans",
                    "LabelConfidence": 0.9879999756813049,
                    "LabelName": "美人",
                    "LabelLevel": 2,
                    "ParentLabelName": "外貌特徵"
                },
                {
                    "CentricScore": 0.8399999737739563,
                    "Language": "zh-Hans",
                    "LabelConfidence": 0.9589999914169312,
                    "LabelName": "人物特寫",
                    "LabelLevel": 2,
                    "ParentLabelName": "其他情境"
                },
                {
                    "CentricScore": 0.8429999947547913,
                    "Language": "zh-Hans",
                    "LabelConfidence": 0.949999988079071,
                    "LabelName": "人像",
                    "LabelLevel": 2,
                    "ParentLabelName": "面部"
                },
                {
                    "CentricScore": 0.8519999980926514,
                    "Language": "zh-Hans",
                    "LabelConfidence": 0.925000011920929,
                    "LabelName": "人",
                    "LabelLevel": 2,
                    "ParentLabelName": "面部"
                },
                {
                    "CentricScore": 0.8859999775886536,
                    "Language": "zh-Hans",
                    "LabelConfidence": 0.9129999876022339,
                    "LabelName": "女孩",
                    "LabelLevel": 2,
                    "ParentLabelName": "面部"
                },
                ...
            ],
            "Orientation": 1,
            "Figures": [
                {
                    "Beard": "none",
                    "MaskConfidence": 0.6959999799728394,
                    "Gender": "female",
                    "Boundary": {
                        "Left": 70,
                        "Top": 75,
                        "Height": 134,
                        "Width": 101
                    },
                    "BeardConfidence": 1,
                    "FigureId": "b51a7c91-1ce7-44d8-ae53-****",
                    "Mouth": "close",
                    "Emotion": "none",
                    "Age": 25,
                    "MouthConfidence": 0.996999979019165,
                    "FigureType": "face",
                    "GenderConfidence": 1,
                    "HeadPose": {
                        "Pitch": 21.562999725341797,
                        "Roll": 12.322999954223633,
                        "Yaw": 11.529999732971191
                    },
                    "Mask": "none",
                    "EmotionConfidence": 0.9819999933242798,
                    "HatConfidence": 1,
                    "GlassesConfidence": 0.9990000128746033,
                    "Sharpness": 1,
                    "FigureClusterId": "figure-cluster-id-unavailable",
                    "FaceQuality": 0.9990000128746033,
                    "Attractive": 0.9819999933242798,
                    "AgeSD": 5,
                    "Glasses": "none",
                    "FigureConfidence": 0.9980000257492065,
                    "Hat": "none"
                }
            ],
            "EXIF": "{\"Compression\":{\"value\":\"6\"},\"DateTime\":{\"value\":\"2020:08:19 17:11:11\"},\"DateTimeOriginal\":{\"value\":\"2020:08:19 17:11:11\"},\"ExifTag\":{\"value\":\"82\"},\"FileSize\":{\"value\":\"22868\"},\"Format\":{\"value\":\"jpg\"},\"GPSLatitude\":{\"value\":\"34deg \"},\"GPSLatitudeRef\":{\"value\":\"North\"},\"GPSLongitude\":{\"value\":\"119deg \"},\"GPSLongitudeRef\":{\"value\":\"East\"},\"GPSMapDatum\":{\"value\":\"WGS-84\"},\"GPSTag\":{\"value\":\"120\"},\"GPSVersionID\":{\"value\":\"2 2 0 0\"},\"ImageHeight\":{\"value\":\"270\"},\"ImageWidth\":{\"value\":\"270\"},\"JPEGInterchangeFormat\":{\"value\":\"294\"},\"JPEGInterchangeFormatLength\":{\"value\":\"2700\"},\"Orientation\":{\"value\":\"1\"},\"ResolutionUnit\":{\"value\":\"2\"},\"XResolution\":{\"value\":\"72/1\"},\"YResolution\":{\"value\":\"72/1\"}}",
            "ContentMd5": "HZwoCnxPZ/fvhz4o****==",
            "ImageHeight": 270,
            "ImageScore": {
                "OverallQualityScore": 0.6140000224113464
            },
            "ETag": "\"1D9C280A7C4F67F7EF873E28****\"",
            "DatasetName": "allfunction",
            "FileHash": "\"1D9C280A7C4F67F7EF873E28****\"",
            "CustomId": "abc",
            "UpdateTime": "2022-07-08T14:34:01.400716231+08:00",
            "OSSCRC64": "56344477456500****",
            "OSSTaggingCount": 0,
            "LatLong": "34.000000,119.000000",
            "OSSObjectType": "Normal"
        }
    ]
}