全部產品
Search
文件中心

:工作流程範本與運算元

更新時間:Dec 12, 2024

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

簡介

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

注意事項

  • 在通過綁定OSS Bucket或調用IndexFileMeta - 索引檔案元資訊BatchIndexFileMeta - 批量索引檔案元資訊介面建立中繼資料索引時,根據資料集和專案配置的工作流程範本來決定要執行的運算元操作。

  • 在資料集中建立中繼資料索引時,資料集的模板優先順序高於專案設定的模板。當資料集模板為空白時,則使用專案設定的模板。

  • 工作流程範本不會對使用者主動使用其他API(例如視頻轉碼、圖片臉部偵測、圖片打分、人臉聚類等)產生限制,但可能因為索引中不存在對應中繼資料,實際不產生效果。

  • 建立索引過程會產生運算元計費和索引儲存費用。費用詳情請參見計費項目

工作流程範本

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

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

運算元

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)建立圖片中繼資料索引為例,介紹如何使用工作流程範本。

  1. 調用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"
          }
      }
  2. 調用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****"
      }
  3. 調用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"
              }
          ]
      }