Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:AddEditingProjectMaterials

Última atualização: Jul 21, 2026

Adiciona um ou mais materiais a um projeto de edição online.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

vod:AddEditingProjectMaterials

create

*全部资源

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ProjectId

string

Sim

O ID do projeto de edição online.

afa31b483b5c41609185de0e1b790579

MaterialIds

string

Sim

Os IDs dos materiais. Separe vários IDs por vírgulas (,). São suportados no máximo 10 IDs de materiais.

Nota

Ao associar vários materiais, certifique-se de que todos os materiais sejam do mesmo tipo e correspondam ao valor de MaterialType.

d3251979f9fd41f2acb29ccda5a6f772

MaterialType

string

Sim

O tipo de material. Valores válidos:

  • video: vídeo.

  • audio: apenas áudio.

  • image: imagem.

video.

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

85237CDA-0B54-5CED-BA10-A8A71AA13C1A.

MaterialList

array<object>

A lista de materiais.

object

Os detalhes do material.

Status

string

O status do material. Valores válidos:

  • Normal: Normal.

  • Uploading: Enviando.

  • UploadFail: Falha no envio.

Normal.

CateId

integer

O ID da categoria.

1000487543

CreateTime

string

A hora em que o material foi criado. A hora segue o formato: aaaa-mm-ddthh:mm:ssz (UTC).

2019-10-02T08:26Z

MaterialType

string

O tipo de material. Valores válidos:

  • video: vídeo.

  • audio: apenas áudio.

  • image: imagem.

video.

Tags

string

As tags do material. Várias tags são separadas por vírgulas (,).

tag1,tag2

SpriteConfig

string

A configuração de sprite.

xxx.

CateName

string

O nome da categoria do material.

Categoria 1

Description

string

A descrição do material.

Descrição do material.

MaterialId

string

O ID do material.

85befc4118b84c6723e53b80b1****

Size

integer

O tamanho do arquivo.

1682694

CoverURL

string

A URL da miniatura do material.

http://example.aliyundoc.com/aivideocover/46fa444aa34065cb9250f6c****/image_01.jpg.

Duration

number

A duração do material. Unidade: segundos. O valor tem precisão de quatro casas decimais.

3690.2332

CustomerId

integer

O ID do usuário.

1234751840694470

Title

string

O título do material.

teste.

ModifyTime

string

A hora em que o material foi modificado pela última vez. A hora segue o formato: aaaa-mm-ddthh:mm:ssz (UTC).

2022-11-25T07:28:34Z

Sprites

array

O array de URLs de sprites do material.

string

A URL do sprite do material.

"http://example.aliyundoc.com/material_big_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key=****"

Snapshots

array

O array de URLs de snapshots do material.

string

A URL do snapshot do material.

"http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key=","http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key="

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "85237CDA-0B54-5CED-BA10-A8A71AA13C1A",
  "MaterialList": [
    {
      "Status": "Normal",
      "CateId": 1000487543,
      "CreateTime": "2019-10-02T08:26Z",
      "MaterialType": "video",
      "Tags": "tag1,tag2",
      "SpriteConfig": "xxx",
      "CateName": "Category 1",
      "Description": "Material description",
      "MaterialId": "85befc4118b84c6723e53b80b1****",
      "Size": 1682694,
      "CoverURL": "http://example.aliyundoc.com/aivideocover/46fa444aa34065cb9250f6c****/image_01.jpg",
      "Duration": 3690.2332,
      "CustomerId": 1234751840694470,
      "Title": "test",
      "ModifyTime": "2022-11-25T07:28:34Z",
      "Sprites": [
        "\"http://example.aliyundoc.com/material_big_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key=****\""
      ],
      "Snapshots": [
        "\"http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key=\",\"http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key=\""
      ]
    }
  ]
}

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.