全部產品
Search

搜尋本產品

    Intelligent Media Services：SearchMediaByAILabel - 智能標籤文本搜尋

    文件中心

    Intelligent Media Services：SearchMediaByAILabel - 智能標籤文本搜尋

    更新時間：Mar 21, 2026

    可以根據人名、字幕、AI分類進行多模搜尋。

    介面說明

    可以根據人名、字幕、AI 分類進行多模搜尋，粗搜支援媒資粒度返回，精搜支援媒資內命中片段資訊返回。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ice:SearchMediaByAILabel

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    SearchLibName

    string

    否

    搜尋庫名稱

    test-1
    MediaType

    string

    否

    媒資類型。取值：

    • image：圖片

    • video：視頻

    • audio：音頻

    枚舉值：

    • image :

      image

    • video :

      video

    • audio :

      audio

    video
    SortBy

    string

    否

    查詢結果排序。取值：

    • CreationTime:Desc（預設值）：按建立時間倒序。

    • CreationTime:Asc：按建立時間升序。

    CreationTime:Desc

    PageNo

    integer

    否

    當前頁碼。預設值為 1。

    1
    PageSize

    integer

    否

    每頁返回的資料條數。預設值為 10，最大值為 50。

    20
    Text

    string

    否

    搜尋內容。

    風箏
    MultimodalSearchType

    string

    否

    多模搜尋類型。預設為全文檢索搜尋。取值：

    • PersonName：人名搜

    • Ocr：字幕搜

    • AiCategory ：AI 分類

    • FullSearch：全文搜

    枚舉值：

    • PersonName :

      PersonName

    • AiCategory :

      AiCategory

    • FullSearch :

      FullSearch

    • Ocr :

      Ocr

    Ocr
    SpecificSearch

    boolean

    否

    是否精搜。取值：

    • true： 精搜

    • false：粗搜

    true
    MediaId

    string

    否

    媒資 ID。精搜時必須攜帶。

    ****c469e944b5a856828dc2****

    MatchingMode

    string

    否

    匹配模式，預設為 fuzzy 模糊比對。取值：

    • fuzzy： 模糊

    • precise：精確，該模式僅對新增媒資生效。

    枚舉值：

    • precise :

      precise

    • fuzzy :

      fuzzy

    fuzzy
    Namespace

    string

    否

    命名空間。

    name-1
    CustomFilters

    string

    否

    自訂過濾。JOSN 字串；支援欄位 Int 型 intField1、字串型 strField1、strField2；同一個欄位最多可選擇一種匹配，不通欄位過濾時是且關係。

    • 精準，如 {"intField1":12,"strField1":"abc"}

    • 多值，如 {"intField1":[12,13],"strField1":["abc","cd"]}

    • 範圍，如 {"intField1":{"gte":12,"lte":13}}

    {"intField1":{"gte":12,"lte":13},"strField2":["cd","de"],"strField1":"abc"}
    UtcCreate

    string

    否

    建立時間，毫秒時間戳記。gte 大於等於，lte 小於等於。

    • 範圍，如{"gte":1761205662998,"lte":1771205662998}

    {"gte":1761205662998,"lte":1771205662998}

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    請求 ID。

    ******11-DB8D-4A9A-875B-275798******
    Success

    string

    是否成功。

    true
    Code

    string

    返回碼。

    200
    MediaList

    array<object>

    符合要求的媒資集合

    array<object>

    媒資資訊詳情。

    AiData

    object

    AI 詳細資料。

    AiLabelInfo

    array<object>

    AI 標籤資訊列表。

    array<object>

    AI 標籤資訊。

    FaceId

    string

    人臉 ID。

    5FE19530C7A422197535FE74F5DB****

    LabelType

    string

    標籤類型。

    物體
    Source

    string

    來源。

    vision
    Category

    string

    分類。

    交通工具
    LabelName

    string

    實體名稱。

    車
    LabelId

    string

    實體 ID。

    103102503**
    Occurrences

    array<object>

    片段資訊。

    array<object>

    片段。

    Score

    number

    打分。

    0.75287705

    Image

    string

    最優人臉圖片。

    https://service-****-public.oss-cn-hangzhou.aliyuncs.com/1563457****438522/service-image/f788974f-9595-43b2-a478-7c7a1afb****.jpg
    TableBatchSeqId

    string

    向量表序列 ID。

    85010D1**
    ClipId

    string

    片段 ID。

    158730355E4B82257D8AA1583A58****
    From

    number

    片段起始時間。

    1.4
    To

    number

    片段結束時間。

    2.5
    FinegrainName

    string

    實體的細粒度名稱。

    車
    FinegrainId

    string

    實體的細粒度 ID。

    103102503**
    Content

    string

    常值內容。

    智能標籤測試

    Tracks

    array<object>

    track 序列。

    object

    序列。

    Size

    number

    人臉 bbox 框的面積。

    50
    Position

    string

    bbox 框位置座標。

    468.0;67.0;615.0;267.0
    Timestamp

    number

    track 的時間戳記。

    1.4
    AsrInfo

    array<object>

    語音資訊列表。

    object

    語音資訊。

    From

    number

    片段起始時間。

    1.4
    To

    number

    片段結束時間。

    2.5
    ClipId

    string

    片段 ID。

    5FE19530C7A422197535FE74F5DB****
    Content

    string

    常值內容。

    智能標籤測試
    Timestamp

    number

    片段時間戳記。

    1.4
    OcrInfo

    array<object>

    字幕資訊列表。

    object

    字幕資訊。

    From

    number

    片段起始時間。

    1.4
    To

    number

    片段結束時間。

    2.5
    ClipId

    string

    片段 ID。

    5FE19530C7A422197535FE74F5DB****

    Content

    string

    常值內容。

    皮皮
    Timestamp

    number

    片段時間戳記。

    1.4
    StorageLocation

    string

    儲存地址。

    out-****.oss-cn-shanghai.aliyuncs.com

    Status

    string

    視頻狀態。

    枚舉值：

    • PrepareFail :

      PrepareFail

    • UploadFail :

      UploadFail

    • Init :

      Init

    • UploadSucc :

      UploadSucc

    • Transcoding :

      Transcoding

    • TranscodeFail :

      TranscodeFail

    • Deleted :

      Deleted

    • Normal :

      Normal

    • Uploading :

      Uploading

    • Preparing :

      Preparing

    • Blocked :

      Blocked

    • Checking :

      Checking

    Normal
    CreationTime

    string

    建立時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2017-11-14T09:15:50Z

    ModificationTime

    string

    更新時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2017-11-14T09:15:50Z

    MediaId

    string

    媒資 ID。

    1c6ce34007d571ed94667630a6bc****

    Tags

    string

    標籤列表。

    標籤1, 標籤2

    Description

    string

    描述。

    阿里雲VOD視頻描述

    AppId

    string

    應用 ID。預設取值：app-1000000。

    app-1000000
    Size

    integer

    源檔案大小。單位：位元組。

    10897890
    CoverUrl

    string

    封面 URL。

    http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****
    Duration

    number

    時間長度（單位：秒）。

    12.2
    Title

    string

    標題。

    史上最牛音樂播放器

    Snapshots

    array

    視頻截圖 URL 數組。

    string

    視頻截圖 URL。

    http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****
    Total

    integer

    合格媒資總數。

    30

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "Success": "true",
  "Code": "200",
  "MediaList": [
    {
      "AiData": {
        "AiLabelInfo": [
          {
            "FaceId": "5FE19530C7A422197535FE74F5DB****\n",
            "LabelType": "物體",
            "Source": "vision",
            "Category": "交通工具",
            "LabelName": "車",
            "LabelId": "103102503**",
            "Occurrences": [
              {
                "Score": 0.75287705,
                "Image": "https://service-****-public.oss-cn-hangzhou.aliyuncs.com/1563457****438522/service-image/f788974f-9595-43b2-a478-7c7a1afb****.jpg",
                "TableBatchSeqId": "85010D1**",
                "ClipId": "158730355E4B82257D8AA1583A58****",
                "From": 1.4,
                "To": 2.5,
                "FinegrainName": "車",
                "FinegrainId": "103102503**",
                "Content": "智能標籤測試\n",
                "Tracks": [
                  {
                    "Size": 50,
                    "Position": "468.0;67.0;615.0;267.0",
                    "Timestamp": 1.4
                  }
                ]
              }
            ]
          }
        ],
        "AsrInfo": [
          {
            "From": 1.4,
            "To": 2.5,
            "ClipId": "5FE19530C7A422197535FE74F5DB****",
            "Content": "智能標籤測試",
            "Timestamp": 1.4
          }
        ],
        "OcrInfo": [
          {
            "From": 1.4,
            "To": 2.5,
            "ClipId": "5FE19530C7A422197535FE74F5DB****\n",
            "Content": "皮皮",
            "Timestamp": 1.4
          }
        ]
      },
      "StorageLocation": "out-****.oss-cn-shanghai.aliyuncs.com\n",
      "Status": "Normal",
      "CreationTime": "2017-11-14T09:15:50Z\n",
      "ModificationTime": "2017-11-14T09:15:50Z\n",
      "MediaId": "1c6ce34007d571ed94667630a6bc****\n",
      "Tags": "標籤1, 標籤2\n",
      "Description": "阿里雲VOD視頻描述\n",
      "AppId": "app-1000000",
      "Size": 10897890,
      "CoverUrl": "http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****",
      "Duration": 12.2,
      "Title": "史上最牛音樂播放器\n",
      "Snapshots": [
        "http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****"
      ]
    }
  ],
  "Total": 30
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。