全部產品
Search
文件中心

Intelligent Media Services:ListPublicMediaBasicInfos - 列出公用素材庫媒資基礎資訊

更新時間:Mar 21, 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

RequestId

string

請求 ID。

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

TotalCount

integer

符合要求的媒資總數。

2

MediaInfos

array<object>

符合要求的媒資集合。

array<object>

MediaId

string

媒資 ID。

****019b82e24b37a1c2958dec38****

MediaBasicInfo

object

媒資基礎資訊。

MediaId

string

媒資 ID。

****019b82e24b37a1c2958dec38****

InputURL

string

待註冊的媒資在相應系統中的地址。

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

MediaType

string

媒資媒體類型。

video

BusinessType

string

媒資業務類型。

general

Source

string

來源。

oss

Title

string

標題。

title標題

Description

string

內容描述。

description

Category

string

分類。

video

MediaTags

string

標籤。

sticker-daily

CoverURL

string

封面地址。

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

UserData

string

使用者資料。

userData

Snapshots

string

截圖。

null

Status

string

資源狀態。

Normal

TranscodeStatus

string

轉碼狀態。

Init

CreateTime

string

媒資建立時間。

2021-01-08T16:52:04Z

ModifiedTime

string

媒資修改時間。

2021-01-08T16:52:04Z

DeletedTime

string

媒資刪除時間。

2021-01-08T16:52:04Z

FileInfoList

array<object>

檔案資訊。

array<object>

FileBasicInfo

object

檔案基礎資訊,包含時間長度,大小等。

FileName

string

檔案名稱。

example.mp4

FileStatus

string

檔案狀態。

Normal

FileType

string

檔案類型。

source_file

FileSize

string

檔案大小(位元組)。

338990717

FileUrl

string

檔案 OSS 地址。

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

Region

string

檔案儲存體地區。

cn-shanghai

FormatName

string

封裝格式。

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

Duration

string

時間長度。

10.040000

Bitrate

string

碼率。

270112.12

Width

string

寬。

1920

Height

string

高。

1080

NextToken

string

用來表示當前調用返回讀取到的位置,空代表資料已經讀取完畢。

8EqYpQbZ6Eh7+Zz8DxVYoQ==

MaxResults

integer

本次請求所返回的最大記錄條數。

2

樣本

正常返回樣本

JSON格式

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情