全部产品
Search
文档中心

智能媒体服务:SearchMediaByHybrid - 混合搜索

更新时间:Aug 27, 2026

媒资混合搜索。智能标签文本搜索和大模型搜索能力合并进行多路召回,用户可以使用自然语言描述进行搜索。

接口说明

阿里云智能媒体服务智能媒资搜索功能使用或问题咨询等,请搜索钉钉群(30415005038)加入智能媒体服务多模检索客户答疑群联系我们。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ice:SearchMediaByHybrid

get

*全部资源

*

无 无

请求参数

名称

类型

必填

描述

示例值

SearchLibName

string

否

搜索库。

test-1

MediaType

string

否

媒资类型。

枚举值:

  • image :

    image

  • video :

    video

video

PageNo

integer

否

当前页码。默认值为 1。

  • image:图片。

  • video:视频。

1

PageSize

integer

否

每页返回的数据条数。默认值为 10,最大值为 50。

20

Text

string

否

搜索内容。

两只熊猫在打架

MediaId

string

否

媒资 ID。携带时返回媒资命中详细信息。

****c469e944b5a856828dc2****

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。

******3B-0E1A-586A-AC29-742247******

Success

string

操作是否成功。true 表示成功,false 表示失败。

true

Code

string

返回码。

200

MediaList

array<object>

符合要求的媒资集合。

array<object>

符合要求的媒资集合。

MediaId

string

媒资 ID。

a18936e0e28771edb59ae6f6f47a****

ClipInfo

array<object>

片段信息。

object

片段信息。

From

number

片段起始时间。

2

To

number

片段结束时间。

4

Score

number

打分。

0.99

Total

integer

满足搜索条件的媒资信息总条数。

30

示例

正常返回示例

JSON格式

{
  "RequestId": "******3B-0E1A-586A-AC29-742247******",
  "Success": "true",
  "Code": "200",
  "MediaList": [
    {
      "MediaId": "a18936e0e28771edb59ae6f6f47a****",
      "ClipInfo": [
        {
          "From": 2,
          "To": 4,
          "Score": 0.99
        }
      ]
    }
  ],
  "Total": 30
}

错误码

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

变更历史

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