根据用户所提供参数,返回符合条件的媒资信息。
接口说明
阿里云智能媒体服务智能媒资搜索功能使用或问题咨询等,请搜索钉钉群(30415005038)加入智能媒体服务多模检索客户答疑群联系我们。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
ice:SearchMedia | get | *全部资源 * |
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
Match | string | 否 | 过滤条件。语法规则,请参见媒资搜索协议。 | title = '中国' and utcCreate = ['1693367158561','1693367158562'] |
SortBy | string | 否 | 排序字段和排序顺序。多个使用英文逗号(,)分隔。 | utcCreate:Desc |
PageNo | integer | 否 | 当前页码。默认值为 1。 | 1 |
PageSize | integer | 否 | 每页返回的数据条数。默认值为 10,最大值为 50。 | 20 |
EntityId | string | 否 | 实体 ID。 | 2d3bf1e35a1e42b5ab338d701efa**** |
ScrollToken | string | 否 | 翻页标识。32 字段。第一次执行搜索请求时不用设置本参数。搜索请求命中数据时,服务端会返回该参数值,用于记录当前搜索数据的位置地址。请记录返回的参数值,下一次搜索时按下述要求或建议设置本参数:需要遍历搜索条件命中的所有数据时,本参数必须设置。当 PageNo 参数取值超过 200 时,建议设置本参数优化搜索性能。只能向后翻页,最大翻页距离为 1000 媒资。 | F8C4F642184DBDA5D93907A70AAE**** |
SearchLibName | string | 否 | 搜索库。 | test-1 |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "6F61C357-ACC0-57FB-876E-D5879533****",
"Success": "True",
"Code": "200",
"MediaInfoList": [
{
"MediaId": "3b187b3620c8490886cfc2a9578c****",
"MediaBasicInfo": {
"MediaId": "132bd600fc3c71ec99476732a78f****",
"InputURL": "oss://clipres/longvideo/material/voice/prod/20220418/07d7c799f6054dc3bbef250854cf8498165024814****",
"MediaType": "video",
"BusinessType": "opening",
"Source": "oss",
"Title": "智能横屏转竖屏",
"Description": "对这个视频进行转码处理了",
"Category": "image",
"MediaTags": "tags,tags2\n",
"CoverURL": "https://dtlive-bj.oss-cn-beijing.aliyuncs.com/cover/e694372e-4f5b-4821-ae09-efd064f2****_large_cover_url.jpg",
"UserData": "userData",
"Snapshots": "[{\"bucket\":\"example-bucket\",\"count\":\"3\",\"iceJobId\":\"******f48f0e4154976b2b8c45******\",\"location\":\"oss-cn-beijing\",\"snapshotRegular\":\"example.jpg\",\"templateId\":\"******e6a6440b29eb60bd7c******\"}]",
"Status": "Normal",
"TranscodeStatus": "Init",
"CreateTime": "2020-12-01T19:48Z",
"ModifiedTime": "2020-12-01T19:48Z\n",
"DeletedTime": "2020-12-01T19:48Z\n",
"SpriteImages": "[{\"bucket\":\"example-bucket\",\"count\":\"32\",\"iceJobId\":\"******83ec44d58b2069def2e******\",\"location\":\"oss-cn-shanghai\",\"snapshotRegular\":\"example/example-{Count}.jpg\",\"spriteRegular\":\"example/example-{TileCount}.jpg\",\"templateId\":\"******e438b14ff39293eaec25******\",\"tileCount\":\"1\"}]",
"CateId": 44,
"Biz": "IMS",
"UploadSource": "general",
"CateName": "子分类1",
"ReferenceId": "123-123"
},
"FileInfoList": [
{
"FileBasicInfo": {
"FileName": "164265080291300080527050.wav",
"FileStatus": "Normal",
"FileType": "source_file",
"FileSize": "324784",
"FileUrl": "https://outin-d3f4681ddfd911ec99a600163e1403e7.oss-cn-shanghai.aliyuncs.com/sv/23d5cdd1-18180984899/23d5cdd1-1818098****.mp4",
"Region": "cn-beijing",
"FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
"Duration": "60.00000\n",
"Bitrate": "1912.13\n",
"Width": "1920",
"Height": "480",
"CreateTime": "2022-05-30T02:02:17Z",
"ModifiedTime": "2021-12-10T12:19Z"
}
}
],
"AiData": {
"AiLabelInfo": [
{
"FaceId": "5FE19530C7A422197535FE74F5DB****",
"LabelType": "物体",
"Source": "vision",
"Category": "交通工具",
"LabelName": "车",
"LabelId": "10310250338",
"Occurrences": [
{
"Score": 0.75287705,
"Image": "99C64F6287",
"TableBatchSeqId": "85010D1",
"clipId": "5FE19530C7A422197535FE74F5DB****",
"From": 1.4,
"To": 2.5,
"FinegrainName": "车",
"FinegrainId": "10310250338",
"Content": "皮皮",
"Tracks": [
{
"Size": 50.2,
"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****",
"Content": "我是皮皮",
"Timestamp": 1.4
}
]
},
"AiRoughData": {
"SaveType": "TEXT",
"Status": "SaveSuccess",
"AiJobId": "cd35b0b0025f71edbfcb472190a9****",
"Result": "http://xxxx.json",
"AiCategory": "视频AI分类"
},
"IndexStatusList": [
{
"IndexType": "mm",
"IndexStatus": "Success"
}
]
}
],
"ScrollToken": "F8C4F642184DBDA5D93907A70AAE****",
"Total": 163
}
错误码
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|---|---|
2024-08-26 | OpenAPI 返回结构发生变更 | 查看变更详情 |
2023-09-26 | OpenAPI 入参发生变更 | 查看变更详情 |
2023-06-27 | OpenAPI 入参发生变更、OpenAPI 返回结构发生变更 | 查看变更详情 |
2022-11-29 | OpenAPI 返回结构发生变更 | 查看变更详情 |
2022-11-15 | OpenAPI 返回结构发生变更 | 查看变更详情 |
2022-07-19 | 新增 OpenAPI | 查看变更详情 |