根据用户所提供参数，返回符合条件的媒资信息。
接口说明
阿里云智能媒体服务智能媒资搜索功能使用或问题咨询等，请搜索钉钉群（30415005038）加入智能媒体服务多模检索客户答疑群联系我们。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
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 |
| CustomFilters |
string |
否 |
自定义过滤。JSON 字符串；支持字段 Int 型 intField1、字符串型 strField1、strField2；同一个字段最多可选择一种匹配，不同字段过滤时是且关系。
|
{"intField1":{"gte":12,"lte":13},"strField2":["cd","de"],"strField1":"abc"} |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response。 |
||
| RequestId |
string |
请求 ID。 |
6F61C357-ACC0-57FB-876E-D5879533**** |
| Success |
string |
是否成功。 |
True |
| Code |
string |
返回码。 |
200 |
| MediaInfoList |
array<object> |
符合要求的媒资集合。 |
|
|
array<object> |
媒资信息列表。 |
||
| MediaId |
string |
媒资 ID。 |
3b187b3620c8490886cfc2a9578c**** |
| MediaBasicInfo |
object |
媒资基础信息。 |
|
| MediaId |
string |
媒资 ID。 |
132bd600fc3c71ec99476732a78f**** |
| InputURL |
string |
待注册的媒资在相应系统中的地址。 |
oss://clipres/longvideo/material/voice/prod/20220418/07d7c799f6054dc3bbef250854cf8498165024814**** |
| MediaType |
string |
媒资媒体类型。 |
video |
| BusinessType |
string |
媒资业务类型。 |
opening |
| Source |
string |
来源。 |
oss |
| Title |
string |
标题。 |
智能横屏转竖屏 |
| Description |
string |
内容描述。 |
对这个视频进行转码处理了 |
| Category |
string |
分类。 |
image |
| MediaTags |
string |
标签。 |
tags,tags2 |
| CoverURL |
string |
封面地址。 |
https://dtlive-bj.oss-cn-beijing.aliyuncs.com/cover/e694372e-4f5b-4821-ae09-efd064f2****_large_cover_url.jpg |
| UserData |
string |
用户数据。 |
userData |
| Snapshots |
string |
截图。 |
[{"bucket":"example-bucket","count":"3","iceJobId":"******f48f0e4154976b2b8c45******","location":"oss-cn-beijing","snapshotRegular":"example.jpg","templateId":"******e6a6440b29eb60bd7c******"}] |
| Status |
string |
资源状态。 |
Normal |
| TranscodeStatus |
string |
转码状态。 |
Init |
| CreateTime |
string |
媒资创建时间。 |
2020-12-01T19:48Z |
| ModifiedTime |
string |
媒资修改时间。 |
2020-12-01T19:48Z |
| DeletedTime |
string |
媒资删除时间。 |
2020-12-01T19:48Z |
| SpriteImages |
string |
雪碧图。 |
[{"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 |
integer |
分类 ID。 |
44 |
| Biz |
string |
媒资所属业务。 |
IMS |
| UploadSource |
string |
上传资源。 |
general |
| CateName |
string |
分类名称。 |
子分类1 |
| ReferenceId |
string |
自定义 ID，仅支持小写字母、大写字母、数字、横线、下划线，长度 6-64 位。用户维度唯一。 |
123-123 |
| Namespace |
string |
命名空间。 |
name-1 |
| VisionDescription |
string |
视觉描述。 |
足球进球 |
| StreamStatus |
string |
流状态 |
Active |
| FileInfoList |
array<object> |
FileInfos。 |
|
|
array<object> |
fileinfo 列表。 |
||
| FileBasicInfo |
object |
文件基础信息，包含时长，大小等。 |
|
| FileName |
string |
文件名。 |
164265080291300080527050.wav |
| FileStatus |
string |
文件状态。 |
Normal |
| FileType |
string |
文件类型。 |
source_file |
| FileSize |
string |
文件大小（字节）。 |
324784 |
| FileUrl |
string |
文件 OSS 地址。 |
https://outin-d3f4681ddfd911ec99a600163e1403e7.oss-cn-shanghai.aliyuncs.com/sv/23d5cdd1-18180984899/23d5cdd1-1818098****.mp4 |
| Region |
string |
文件存储区域。 |
cn-beijing |
| FormatName |
string |
封装格式。 |
mov,mp4,m4a,3gp,3g2,mj2 |
| Duration |
string |
时长。 |
60.00000 |
| Bitrate |
string |
码率。 |
1912.13 |
| Width |
string |
宽。 |
1920 |
| Height |
string |
高。 |
480 |
| CreateTime |
string |
创建时间。 |
2022-05-30T02:02:17Z |
| ModifiedTime |
string |
最后修改时间。 |
2021-12-10T12:19Z |
| ImagesInput |
string |
图片集信息。 |
{} |
| 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 |
10310250338 |
| Occurrences |
array<object> |
片段列表 |
|
|
array<object> |
片段 |
||
| Score |
number |
打分 |
0.75287705 |
| Image |
string |
最优人脸图片的 base64 编码 |
99C64F6287 |
| TableBatchSeqId |
string |
向量表序列 ID |
85010D1 |
| clipId |
string |
片段 ID |
5FE19530C7A422197535FE74F5DB**** |
| From |
number |
片段起始时间 |
1.4 |
| To |
number |
片段结束时间 |
2.5 |
| FinegrainName |
string |
实体的细粒度名称 |
车 |
| FinegrainId |
string |
实体的细粒度 ID |
10310250338 |
| Content |
string |
文本内容 |
皮皮 |
| Tracks |
array<object> |
track 序列 |
|
|
object |
序列 |
||
| Size |
number |
人脸 bbox 框的面积 |
50.2 |
| 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 |
| AiRoughData |
object |
AI 简介数据 |
|
| SaveType |
string |
保存类型 |
TEXT |
| Status |
string |
数据状态 |
SaveSuccess |
| AiJobId |
string |
AI 任务 ID |
cd35b0b0025f71edbfcb472190a9**** |
| Result |
string |
AI 结果 |
http://xxxx.json |
| AiCategory |
string |
电视剧 |
视频AI分类 |
| IndexStatusList |
array<object> |
索引状态列表。 |
|
|
object |
索引状态。 |
||
| IndexType |
string |
索引类别。取值：
|
mm |
| IndexStatus |
string |
索引状态。取值：
|
Success |
| CustomFields |
string |
自定义过滤参数。 |
{\"intField1\":12,\"strField1\":\"abc\"} |
| ScrollToken |
string |
翻页标识。 |
F8C4F642184DBDA5D93907A70AAE**** |
| Total |
integer |
符合条件的媒资总数。 |
163 |
示例
正常返回示例
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",
"Namespace": "name-1",
"VisionDescription": "足球进球",
"StreamStatus": "Active"
},
"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",
"ImagesInput": "{}"
}
}
],
"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"
}
],
"CustomFields": "{\\\"intField1\\\":12,\\\"strField1\\\":\\\"abc\\\"}"
}
],
"ScrollToken": "F8C4F642184DBDA5D93907A70AAE****",
"Total": 163
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。