全部产品
Search
文档中心

智能媒体服务:ListPublicMediaBasicInfos - 列出公共素材库媒资基础信息

更新时间:Sep 11, 2026

列出符合条件的公共素材库媒资基础信息,最多筛选出100条。

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值

MediaTagId

string

否

媒资标签,根据此 mediaTagId 进行匹配,返回所有包含此标签的媒资。取值:

  • sticker(贴纸类型)
    • sticker-atmosphere:气氛

    • sticker-bubble:气泡

    • sticker-cute:可爱

    • sticker-daily:日常

    • sticker-expression:表情

    • sticker-gif:动图

  • bgm(背景音乐类型)
    • bgm-romantic:浪漫

    • bgm-cuisine:美食

    • bgm-chinese-style:国风

    • bgm-upbeat:轻快

    • bgm-dynamic:动感

    • bgm-relaxing:舒缓

    • bgm-quirky:搞怪

    • bgm-beauty:时尚/美妆

  • bgi(背景图片类型)
    • bgi-grad:渐变背景

    • bgi-solid:纯色背景

    • bgi-pic:图片背景

sticker-atmosphere

NextToken

string

否

用来表示当前调用返回读取到的位置,空代表数据已经读取完毕。

pSa1SQ0wCe5pzVrQ6mWZEw==

MaxResults

integer

否

本次请求所返回的最大记录条数。

最大值:100,默认值:10

5

PageNo

integer

否

当前页码。默认值为 1

1

PageSize

integer

否

分页大小,每页显示条数。默认值为 10,最大值为 100。

10

IncludeFileBasicInfo

boolean

否

如果为 true,返回值中包含文件基础信息。

true

BusinessType

string

否

媒资业务类型。取值范围:

  • sticker:贴纸

  • bgm:背景音乐

  • bgi:背景图片

sticker

返回参数

名称

类型

描述

示例值

object

Schema of Response

MaxResults

integer

本次请求所返回的最大记录条数。

2

MediaInfos

array<object>

符合要求的媒资集合。

array<object>

FileInfoList

array<object>

文件信息。

array<object>

FileBasicInfo

object

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

Bitrate

string

码率。

270112.12

Duration

string

时长。

10.040000

FileName

string

文件名。

example.mp4

FileSize

string

文件大小(字节)。

338990717

FileStatus

string

文件状态。

Normal

FileType

string

文件类型。

source_file

FileUrl

string

文件 OSS 地址。

http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=

FormatName

string

封装格式。

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

Height

string

高。

1080

Region

string

文件存储区域。

cn-shanghai

Width

string

宽。

1920

MediaBasicInfo

object

媒资基础信息。

BusinessType

string

媒资业务类型。

general

Category

string

分类。

video

CoverURL

string

封面地址。

http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=

CreateTime

string

媒资创建时间。

2021-01-08T16:52:04Z

DeletedTime

string

媒资删除时间。

2021-01-08T16:52:04Z

Description

string

内容描述。

description

InputURL

string

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

https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4

MediaId

string

媒资 ID。

****019b82e24b37a1c2958dec38****

MediaTags

string

标签。

sticker-daily

MediaType

string

媒资媒体类型。

video

ModifiedTime

string

媒资修改时间。

2021-01-08T16:52:04Z

Snapshots

string

截图。

null

Source

string

来源。

oss

Status

string

资源状态。

Normal

Title

string

标题。

My video title

TranscodeStatus

string

转码状态。

Init

UserData

string

用户数据。

userData

MediaId

string

媒资 ID。

****019b82e24b37a1c2958dec38****

NextToken

string

用来表示当前调用返回读取到的位置,空代表数据已经读取完毕。

8EqYpQbZ6Eh7+Zz8DxVYoQ==

RequestId

string

请求 ID。

******B7-7F87-4792-BFE9-63CD21******

TotalCount

integer

符合要求的媒资总数。

2

示例

正常返回示例

JSON格式

{
  "MaxResults": 2,
  "MediaInfos": [
    {
      "FileInfoList": [
        {
          "FileBasicInfo": {
            "Bitrate": "270112.12",
            "Duration": "10.040000",
            "FileName": "example.mp4",
            "FileSize": "338990717",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=",
            "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
            "Height": "1080",
            "Region": "cn-shanghai",
            "Width": "1920"
          }
        }
      ],
      "MediaBasicInfo": {
        "BusinessType": "general",
        "Category": "video",
        "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
        "CreateTime": "2021-01-08T16:52:04Z",
        "DeletedTime": "2021-01-08T16:52:04Z",
        "Description": "description",
        "InputURL": "https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4",
        "MediaId": "****019b82e24b37a1c2958dec38****",
        "MediaTags": "sticker-daily",
        "MediaType": "video",
        "ModifiedTime": "2021-01-08T16:52:04Z",
        "Snapshots": "null",
        "Source": "oss",
        "Status": "Normal",
        "Title": "My video title",
        "TranscodeStatus": "Init",
        "UserData": "userData"
      },
      "MediaId": "****019b82e24b37a1c2958dec38****"
    }
  ],
  "NextToken": "8EqYpQbZ6Eh7+Zz8DxVYoQ==",
  "RequestId": "******B7-7F87-4792-BFE9-63CD21******",
  "TotalCount": 2
}

错误码

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

变更历史

更多信息,参考变更详情。