Todos os produtos
Search
Central de documentação

Intelligent Media Services:ListPublicMediaBasicInfos

Última atualização: Jun 29, 2026

Consulta uma lista de ativos de mídia na biblioteca de mídia pública que atendem às condições especificadas. Podem ser retornados no máximo 100 ativos de mídia.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

MediaTagId

string

Não

A tag de mídia. Todos os ativos de mídia que contêm a tag de mídia especificada são retornados. Valores válidos:

  • Tags de adesivos:

    • sticker-atmosphere

    • sticker-bubble

    • sticker-cute

    • sticker-daily

    • sticker-expression

    • sticker-gif

  • Tags de música de fundo (BGM):

    • bgm-romantic

    • bgm-cuisine

    • bgm-chinese-style

    • bgm-upbeat

    • bgm-dynamic

    • bgm-relaxing

    • bgm-quirky

    • bgm-beauty

  • Tags de imagem de fundo (BGI):

    • bgi-grad

    • bgi-solid

    • bgi-pic

sticker-atmosphere

NextToken

string

Não

O token de paginação que é usado na próxima solicitação para recuperar uma nova página de resultados. Você não precisa especificar este parâmetro na primeira solicitação. Você deve especificar o token obtido da consulta anterior como o valor de NextToken.

pSa1SQ0wCe5pzVrQ6mWZEw==

MaxResults

integer

Não

O número máximo de entradas a serem retornadas.

Valor máximo: 100. Valor padrão: 10.

5

PageNo

integer

Não

O número da página. Valor padrão: 1.

1

PageSize

integer

Não

O número de entradas por página. Valor padrão: 10. Valor máximo: 100.

10

IncludeFileBasicInfo

boolean

Não

Especifica se as informações básicas do ativo de mídia devem ser retornadas.

true

BusinessType

string

Não

O tipo de negócio do ativo de mídia. Valores válidos:

  • sticker

  • bgm

  • bgi

sticker

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os parâmetros de resposta.

RequestId

string

O ID da solicitação.

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

TotalCount

integer

O número total de ativos de mídia que atendem às condições especificadas.

2

MediaInfos

array<object>

Os ativos de mídia que atendem às condições especificadas.

array<object>

MediaId

string

O ID do ativo de mídia.

****019b82e24b37a1c2958dec38****

MediaBasicInfo

object

As informações básicas do ativo de mídia.

MediaId

string

The ID of the media asset.

****019b82e24b37a1c2958dec38****

InputURL

string

The URL of the media asset in another service.

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

MediaType

string

The type of the media asset.

video

BusinessType

string

The business type of the media asset.

general

Source

string

The source of the media asset.

oss

Title

string

The title of the media asset.

My video title

Description

string

The description of the media asset.

description

Category

string

The category of the media asset.

video

MediaTags

string

The tags of the media asset.

sticker-daily

CoverURL

string

The thumbnail URL of the media asset.

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

UserData

string

The user data.

userData

Snapshots

string

The snapshots of the media asset.

null

Status

string

The status of the media asset.

Normal

TranscodeStatus

string

The transcoding status of the media asset.

Init

CreateTime

string

The time when the media asset was created.

2021-01-08T16:52:04Z

ModifiedTime

string

The time when the media asset was last modified.

2021-01-08T16:52:04Z

DeletedTime

string

The time when the media asset was deleted.

2021-01-08T16:52:04Z

FileInfoList

array<object>

As informações de arquivo do ativo de mídia.

array<object>

FileBasicInfo

object

The basic information of the file, such as the duration and size.

FileName

string

The file name.

example.mp4

FileStatus

string

The file status.

Normal

FileType

string

The file type.

source_file

FileSize

string

The file size. Unit: bytes.

338990717

FileUrl

string

The Object Storage Service (OSS) URL of the file.

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

Region

string

The region in which the file resides.

cn-shanghai

FormatName

string

The container format.

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

Duration

string

The duration.

10.040000

Bitrate

string

The bitrate.

270112.12

Width

string

The width.

1920

Height

string

The height.

1080

NextToken

string

Um token de paginação. Ele pode ser usado na próxima solicitação para recuperar uma nova página de resultados. Se NextToken estiver vazio, não há próxima página.

8EqYpQbZ6Eh7+Zz8DxVYoQ==

MaxResults

integer

O número máximo de entradas retornadas.

2

Exemplos

Resposta de sucesso

JSON formato

{
  "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": "My video 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
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.