调用SearchMedia搜索媒体信息_智能媒体服务(IMS)-阿里云帮助中心

根据用户所提供参数，返回符合条件的媒资信息。

接口说明

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

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
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

返回参数

名称	类型	描述	示例值
	object	Schema of Response。
RequestId	string	请求 ID。	6F61C357-ACC0-57FB-876E-D5879533****
Success	string	是否成功。	True
Code	string	返回码。	200
MediaInfoList	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	long	分类 ID。	44
Biz	string	媒资所属业务。	IMS
UploadSource	string	上传资源。	general
CateName	string	分类名称。	子分类1
ReferenceId	string	自定义 ID，仅支持小写字母、大写字母、数字、横线、下划线，长度 6-64 位。用户维度唯一。	123-123
FileInfoList	object []	FileInfos。
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
AiData	object	AI 详细信息
AiLabelInfo	object []	AI 标签信息列表
FaceId	string	人脸 ID	5FE19530C7A422197535FE74F5DB****
LabelType	string	标签类型	物体
Source	string	来源	vision
Category	string	分类	交通工具
LabelName	string	实体名称	车
LabelId	string	实体 ID	10310250338
Occurrences	object []	片段列表
Score	double	打分	0.75287705
Image	string	最优人脸图片的 base64 编码	99C64F6287
TableBatchSeqId	string	向量表序列 ID	85010D1
clipId	string	片段 ID	5FE19530C7A422197535FE74F5DB****
From	double	片段起始时间	1.4
To	double	片段结束时间	2.5
FinegrainName	string	实体的细粒度名称	车
FinegrainId	string	实体的细粒度 ID	10310250338
Content	string	文本内容	皮皮
Tracks	object []	track 序列
Size	double	人脸 bbox 框的面积	50.2
Position	string	bbox 框位置坐标	468.0;67.0;615.0;267.0
Timestamp	double	track 的时间戳	1.4
AsrInfo	object []	语音信息列表
From	double	片段起始时间	1.4
To	double	片段结束时间	2.5
ClipId	string	片段 ID	5FE19530C7A422197535FE74F5DB****
Content	string	文本内容	我是皮皮
Timestamp	double	片段时间戳	1.4
OcrInfo	object []	字幕信息列表
From	double	片段起始时间	1.4
To	double	片段结束时间	2.5
ClipId	string	片段 ID	5FE19530C7A422197535FE74F5DB****
Content	string	文本内容	我是皮皮
Timestamp	double	片段时间戳	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分类
ScrollToken	string	翻页标识。	F8C4F642184DBDA5D93907A70AAE****
Total	long	符合条件的媒资总数。	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"
      },
      "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分类"
      }
    }
  ],
  "ScrollToken": "F8C4F642184DBDA5D93907A70AAE****",
  "Total": 163
}