AI 助理
文档备案控制台
官方文档
首页 智能媒体服务 开发参考 API参考 API目录 媒资管理 媒资搜索 搜索功能 智能标签搜索 SearchMediaByAILabel - 智能标签文本搜索

SearchMediaByAILabel - 智能标签文本搜索

更新时间：
复制 MD 格式
产品详情
我的收藏

可以根据人名、字幕、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

否

搜索内容。

kite
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

标签类型。

object
Source

string

来源。

vision
Category

string

分类。

Means of transportation
LabelName

string

实体名称。

Car
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

实体的细粒度名称。

Car
FinegrainId

string

实体的细粒度 ID。

103102503**
Content

string

文本内容。

Smart label test
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

文本内容。

Smart label test
Timestamp

number

片段时间戳。

1.4
OcrInfo

array<object>

字幕信息列表。

object

字幕信息。

From

number

片段起始时间。

1.4
To

number

片段结束时间。

2.5
ClipId

string

片段 ID。

5FE19530C7A422197535FE74F5DB****

Content

string

文本内容。

Pipi
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

标签列表。

Tag1, Tag2

Description

string

描述。

Alibaba Cloud VOD video description

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

标题。

The greatest music player in history.

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": "object",
            "Source": "vision",
            "Category": "Means of transportation",
            "LabelName": "Car",
            "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": "Car",
                "FinegrainId": "103102503**",
                "Content": "Smart label test",
                "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": "Smart label test",
            "Timestamp": 1.4
          }
        ],
        "OcrInfo": [
          {
            "From": 1.4,
            "To": 2.5,
            "ClipId": "5FE19530C7A422197535FE74F5DB****\n",
            "Content": "Pipi",
            "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": "Tag1, Tag2\n",
      "Description": "Alibaba Cloud VOD video description\n",
      "AppId": "app-1000000",
      "Size": 10897890,
      "CoverUrl": "http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****",
      "Duration": 12.2,
      "Title": "The greatest music player in history.\n",
      "Snapshots": [
        "http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****"
      ]
    }
  ],
  "Total": 30
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。

上一篇：智能标签搜索下一篇：大模型搜索