SearchMedia - 搜索媒体信息

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

接口说明

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

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ice:SearchMediaget
*全部资源
*

请求参数

名称类型必填描述示例值
Matchstring

过滤条件。语法规则,请参见媒资搜索协议

title = '中国' and utcCreate = ['1693367158561','1693367158562']
SortBystring

排序字段和排序顺序。多个使用英文逗号(,)分隔。

utcCreate:Desc
PageNointeger

当前页码。默认值为 1。

1
PageSizeinteger

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

20
EntityIdstring

实体 ID。

2d3bf1e35a1e42b5ab338d701efa****
ScrollTokenstring

翻页标识。32 字段。第一次执行搜索请求时不用设置本参数。搜索请求命中数据时,服务端会返回该参数值,用于记录当前搜索数据的位置地址。请记录返回的参数值,下一次搜索时按下述要求或建议设置本参数:需要遍历搜索条件命中的所有数据时,本参数必须设置。当 PageNo 参数取值超过 200 时,建议设置本参数优化搜索性能。只能向后翻页,最大翻页距离为 1000 媒资。

F8C4F642184DBDA5D93907A70AAE****
SearchLibNamestring

搜索库。

test-1

返回参数

名称类型描述示例值
object

Schema of Response。

RequestIdstring

请求 ID。

6F61C357-ACC0-57FB-876E-D5879533****
Successstring

是否成功。

True
Codestring

返回码。

200
MediaInfoListarray<object>

符合要求的媒资集合。

MediaInfoobject

媒资信息列表。

MediaIdstring

媒资 ID。

3b187b3620c8490886cfc2a9578c****
MediaBasicInfoobject

媒资基础信息。

MediaIdstring

媒资 ID。

132bd600fc3c71ec99476732a78f****
InputURLstring

待注册的媒资在相应系统中的地址。

oss://clipres/longvideo/material/voice/prod/20220418/07d7c799f6054dc3bbef250854cf8498165024814****
MediaTypestring

媒资媒体类型。

video
BusinessTypestring

媒资业务类型。

opening
Sourcestring

来源。

oss
Titlestring

标题。

智能横屏转竖屏
Descriptionstring

内容描述。

对这个视频进行转码处理了
Categorystring

分类。

image
MediaTagsstring

标签。

tags,tags2
CoverURLstring

封面地址。

https://dtlive-bj.oss-cn-beijing.aliyuncs.com/cover/e694372e-4f5b-4821-ae09-efd064f2****_large_cover_url.jpg
UserDatastring

用户数据。

userData
Snapshotsstring

截图。

[{"bucket":"example-bucket","count":"3","iceJobId":"******f48f0e4154976b2b8c45******","location":"oss-cn-beijing","snapshotRegular":"example.jpg","templateId":"******e6a6440b29eb60bd7c******"}]
Statusstring

资源状态。

Normal
TranscodeStatusstring

转码状态。

Init
CreateTimestring

媒资创建时间。

2020-12-01T19:48Z
ModifiedTimestring

媒资修改时间。

2020-12-01T19:48Z
DeletedTimestring

媒资删除时间。

2020-12-01T19:48Z
SpriteImagesstring

雪碧图。

[{"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"}]
CateIdlong

分类 ID。

44
Bizstring

媒资所属业务。

IMS
UploadSourcestring

上传资源。

general
CateNamestring

分类名称。

子分类1
ReferenceIdstring

自定义 ID,仅支持小写字母、大写字母、数字、横线、下划线,长度 6-64 位。用户维度唯一。

123-123
FileInfoListarray<object>

FileInfos。

FileInfoobject

fileinfo 列表。

FileBasicInfoobject

文件基础信息,包含时长,大小等。

FileNamestring

文件名。

164265080291300080527050.wav
FileStatusstring

文件状态。

Normal
FileTypestring

文件类型。

source_file
FileSizestring

文件大小(字节)。

324784
FileUrlstring

文件 OSS 地址。

https://outin-d3f4681ddfd911ec99a600163e1403e7.oss-cn-shanghai.aliyuncs.com/sv/23d5cdd1-18180984899/23d5cdd1-1818098****.mp4
Regionstring

文件存储区域。

cn-beijing
FormatNamestring

封装格式。

mov,mp4,m4a,3gp,3g2,mj2
Durationstring

时长。

60.00000
Bitratestring

码率。

1912.13
Widthstring

宽。

1920
Heightstring

高。

480
CreateTimestring

创建时间。

2022-05-30T02:02:17Z
ModifiedTimestring

最后修改时间。

2021-12-10T12:19Z
AiDataobject

AI 详细信息

AiLabelInfoarray<object>

AI 标签信息列表

AiLabelInfoobject

AI 标签信息

FaceIdstring

人脸 ID

5FE19530C7A422197535FE74F5DB****
LabelTypestring

标签类型

物体
Sourcestring

来源

vision
Categorystring

分类

交通工具
LabelNamestring

实体名称

LabelIdstring

实体 ID

10310250338
Occurrencesarray<object>

片段列表

Occurrencesobject

片段

Scoredouble

打分

0.75287705
Imagestring

最优人脸图片的 base64 编码

99C64F6287
TableBatchSeqIdstring

向量表序列 ID

85010D1
clipIdstring

片段 ID

5FE19530C7A422197535FE74F5DB****
Fromdouble

片段起始时间

1.4
Todouble

片段结束时间

2.5
FinegrainNamestring

实体的细粒度名称

FinegrainIdstring

实体的细粒度 ID

10310250338
Contentstring

文本内容

皮皮
Tracksarray<object>

track 序列

Tracksobject

序列

Sizedouble

人脸 bbox 框的面积

50.2
Positionstring

bbox 框位置坐标

468.0;67.0;615.0;267.0
Timestampdouble

track 的时间戳

1.4
AsrInfoarray<object>

语音信息列表

AsrInfoobject

语音信息

Fromdouble

片段起始时间

1.4
Todouble

片段结束时间

2.5
ClipIdstring

片段 ID

5FE19530C7A422197535FE74F5DB****
Contentstring

文本内容

我是皮皮
Timestampdouble

片段时间戳

1.4
OcrInfoarray<object>

字幕信息列表

OcrInfoobject

字幕信息

Fromdouble

片段起始时间

1.4
Todouble

片段结束时间

2.5
ClipIdstring

片段 ID

5FE19530C7A422197535FE74F5DB****
Contentstring

文本内容

我是皮皮
Timestampdouble

片段时间戳

1.4
AiRoughDataobject

AI 简介数据

SaveTypestring

保存类型

TEXT
Statusstring

数据状态

SaveSuccess
AiJobIdstring

AI 任务 ID

cd35b0b0025f71edbfcb472190a9****
Resultstring

AI 结果

http://xxxx.json
AiCategorystring

电视剧

视频AI分类
IndexStatusListarray<object>

索引状态列表。

IndexStatusInfoobject

索引状态。

IndexTypestring

索引类别。取值:

  • mm:大模型。
  • face:人脸。
  • aiLabel:智能标签。
mm
IndexStatusstring

索引状态。取值:

  • Running:运行中。
  • Fail:失败。
  • Success: 成功。
Success
ScrollTokenstring

翻页标识。

F8C4F642184DBDA5D93907A70AAE****
Totallong

符合条件的媒资总数。

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分类"
      },
      "IndexStatusList": [
        {
          "IndexType": "mm",
          "IndexStatus": "Success"
        }
      ]
    }
  ],
  "ScrollToken": "F8C4F642184DBDA5D93907A70AAE****",
  "Total": 163
}

错误码

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

变更历史

变更时间变更内容概要操作
2024-08-26OpenAPI 返回结构发生变更查看变更详情
2023-09-26OpenAPI 入参发生变更查看变更详情
2023-06-27OpenAPI 入参发生变更、OpenAPI 返回结构发生变更查看变更详情
2022-11-29OpenAPI 返回结构发生变更查看变更详情
2022-11-15OpenAPI 返回结构发生变更查看变更详情
2022-07-19新增 OpenAPI查看变更详情