SearchMedia - 搜索媒体信息

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

调试

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

调试

授权信息

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

请求参数

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

过滤条件,支持以下字段搜索

  • fullText 全文(支持标题、描述、标签tag)
  • title 标题
  • description 描述
  • mediaId 媒资id
  • tags 打标
  • cateId 分类
  • status 状态(int)
  • userId 用户id(int)
  • utcCreate 创建时间(int)
  • utcModified 修改时间(int)
  • fileInfo.storageLocation 位置
  • ocrInfo.tracks.content 字幕
  • aiLabelInfo.category AI分类
  • aiLabelInfo.label_id 内容标签

status枚举

  • INIT(0, "Init"),
  • PREPARING(1, "Preparing"),
  • PREPARE_FAIL(2, "PrepareFail"),
  • NORMAL(3, "Normal"),
  • UPLOADING(10, "Uploading"),
  • UPLOADED(12, "UploadSucc"),
  • ENCODING(13, "Transcoding"),
  • ENCODE_FAILED(14, "TranscodeFail"),
  • CHECKING(15, "Checking"),
  • BLOCKED(16, "Blocked"),
  • DELETED(17, "Deleted"),
  • UPLOAD_FAIL(18, "UploadFail"),
fullText = 'test-1' and title = '中国' and mediaId == 'id' and utcCreate = ('1','2')
SortBystring

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

utcCreate:Desc, utcModified:Desc
PageNointeger

当前页码。默认值为1。

1
PageSizeinteger

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

20
EntityIdstring

实体ID。

2d3bf1e35a1e42b5ab338d701efa7603

返回参数

名称类型描述示例值
object

Schema of Response。

RequestIdstring

请求ID。

6F61C357-ACC0-57FB-876E-D58795335E59
Successstring

是否成功。

True
Codestring

返回码。

200
MediaInfoListarray

符合要求的媒资集合。

object

媒资信息列表。

MediaIdstring

媒资ID。

3b187b3620c8490886cfc2a9578c3ce6
MediaBasicInfoobject

媒资基础信息。

MediaIdstring

媒资ID。

132bd600fc3c71ec99476732a78f6402
InputURLstring

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

oss://clipres/longvideo/material/voice/prod/20220418/07d7c799f6054dc3bbef250854cf84981650248140427
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-efd064f27b63_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

FileInfos。

object

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-18180984899.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

AI标签信息列表

object

AI标签信息

FaceIdstring

人脸ID

5FE19530C7A422197535FE74F5DB2B9F
LabelTypestring

标签类型

物体
Sourcestring

来源

vision
Categorystring

分类

交通工具
LabelNamestring

实体名称

LabelIdstring

实体ID

10310250338
Occurrencesarray

片段列表

object

片段

Scorenumber

打分

0.75287705
Imagestring

最优人脸图片的base64编码

99C64F6287
TableBatchSeqIdstring

向量表序列ID

85010D1
clipIdstring

片段ID

5FE19530C7A422197535FE74F5DB2B9F
Fromnumber

片段起始时间

1.4
Tonumber

片段结束时间

2.5
FinegrainNamestring

实体的细粒度名称

FinegrainIdstring

实体的细粒度ID

10310250338
Contentstring

文本内容

皮皮
Tracksarray

track序列

object

序列

Sizenumber

人脸bbox框的面积

50.2
Positionstring

bbox框位置坐标

468.0;67.0;615.0;267.0
Timestampnumber

track的时间戳

1.4
AsrInfoarray

语音信息列表

object

语音信息

Fromnumber

片段起始时间

1.4
Tonumber

片段结束时间

2.5
ClipIdstring

片段ID

5FE19530C7A422197535FE74F5DB2B9F
Contentstring

文本内容

我是皮皮
Timestampnumber

片段时间戳

1.4
OcrInfoarray

字幕信息列表

object

字幕信息

Fromnumber

片段起始时间

1.4
Tonumber

片段结束时间

2.5
ClipIdstring

片段ID

5FE19530C7A422197535FE74F5DB2B9F
Contentstring

文本内容

我是皮皮
Timestampnumber

片段时间戳

1.4
AiRoughDataobject

AI简介数据

SaveTypestring

保存类型

TEXT
Statusstring

数据状态

SaveSuccess
AiJobIdstring

AI任务ID

cd35b0b0025f71edbfcb472190a9xxxx
Resultstring

AI结果

http://xxxx.json
AiCategorystring

电视剧

视频AI分类
Totallong

符合条件的媒资总数。

163

示例

正常返回示例

JSON格式

{
  "RequestId": "6F61C357-ACC0-57FB-876E-D58795335E59",
  "Success": "True",
  "Code": "200",
  "MediaInfoList": [
    {
      "MediaId": "3b187b3620c8490886cfc2a9578c3ce6",
      "MediaBasicInfo": {
        "MediaId": "132bd600fc3c71ec99476732a78f6402",
        "InputURL": "oss://clipres/longvideo/material/voice/prod/20220418/07d7c799f6054dc3bbef250854cf84981650248140427",
        "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-efd064f27b63_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-18180984899.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": "5FE19530C7A422197535FE74F5DB2B9F",
            "LabelType": "物体",
            "Source": "vision",
            "Category": "交通工具",
            "LabelName": "车",
            "LabelId": "10310250338",
            "Occurrences": [
              {
                "Score": 0.75287705,
                "Image": "99C64F6287",
                "TableBatchSeqId": "85010D1",
                "clipId": "5FE19530C7A422197535FE74F5DB2B9F",
                "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": "5FE19530C7A422197535FE74F5DB2B9F",
            "Content": "我是皮皮",
            "Timestamp": 1.4
          }
        ],
        "OcrInfo": [
          {
            "From": 1.4,
            "To": 2.5,
            "ClipId": "5FE19530C7A422197535FE74F5DB2B9F",
            "Content": "我是皮皮",
            "Timestamp": 1.4
          }
        ]
      },
      "AiRoughData": {
        "SaveType": "TEXT",
        "Status": "SaveSuccess",
        "AiJobId": "cd35b0b0025f71edbfcb472190a9xxxx",
        "Result": "http://xxxx.json",
        "AiCategory": "视频AI分类"
      }
    }
  ],
  "Total": 163
}

错误码

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

变更历史

变更时间变更内容概要操作
2022-11-29OpenAPI 返回结构发生变更
变更项变更内容
出参OpenAPI 返回结构发生变更
2022-11-29
变更项变更内容
2022-11-15OpenAPI 返回结构发生变更
变更项变更内容
出参OpenAPI 返回结构发生变更
2022-07-19
变更项变更内容
2022-07-19新增 OpenAPI
阿里云首页 智能媒体生产 相关技术圈