ProduceEditingProjectVideo - ApsaraVideo VOD: Central de Documentação do Alibaba Cloud

Produz um ou mais vídeos em um vídeo finalizado. Você pode enviar os vídeos de origem diretamente por meio do parâmetro Timeline ou criar primeiro um projeto de edição online e depois enviá-lo para produção.

Descrição da operação

Antes de usar esta operação, certifique-se de estar familiarizado com os métodos de cobrança e preços do ApsaraVideo VOD. A edição online é um recurso pago. Para obter mais informações sobre cobrança, consulte Cobrança de edição e produção de vídeo.
Esta é uma operação assíncrona. Após o envio de uma tarefa, o ID do projeto de edição online é retornado (o vídeo ainda não foi produzido e a tarefa entra em uma fila para execução assíncrona). O resultado final é enviado por meio de uma notificação de callback. Você também pode chamar GetEditingProject para consultar o status da tarefa.
Os recursos de vídeo usados na linha do tempo de edição online podem ser materiais da biblioteca de materiais ou vídeos da biblioteca de mídia. Se você usar vídeos da biblioteca de mídia, certifique-se de que o status deles seja Normal.
Os vídeos são produzidos com base em ProjectId e Timeline. A lógica é a seguinte:
- ProjectId e Timeline não podem estar ambos vazios. Caso contrário, não haverá base para produzir vídeos.
- Se ProjectId estiver vazio e Timeline não estiver vazio, um projeto de edição online será criado automaticamente com a Timeline especificada. Os materiais referenciados na Timeline são extraídos e definidos como materiais do projeto. Em seguida, a produção do vídeo começa.
- Se ProjectId não estiver vazio e Timeline estiver vazio, a Timeline salva mais recentemente será recuperada com base no ProjectId e usada para produzir vídeos.
- Se tanto ProjectId quanto Timeline não estiverem vazios, a Timeline especificada será usada para produzir vídeos e o projeto de edição online correspondente será atualizado (Timeline e materiais do projeto). Se outros campos forem especificados, os campos correspondentes do projeto também serão atualizados.
O número máximo de faixas para faixas de vídeo, faixas de imagem e faixas de legenda é 100 cada.
O número total de materiais não pode exceder 200, e o tamanho total dos arquivos de materiais não pode exceder 1 TB.
A região do bucket de entrada ou saída deve ser a mesma região onde o serviço ApsaraVideo VOD é utilizado.
Quando a saída for um vídeo, os seguintes limites de resolução se aplicam ao vídeo finalizado:
- Tanto a largura quanto a altura devem ter pelo menos 128 px.
- Tanto a largura quanto a altura devem ter no máximo 4096 px.
- O lado menor deve ter no máximo 2160 px.
Após a conclusão da produção do vídeo, ele é carregado automaticamente no ApsaraVideo VOD. Portanto, após a conclusão da produção do vídeo, o ApsaraVideo VOD envia as notificações de evento ProduceMediaComplete e FileUploadComplete. Após a conclusão da transcodificação do vídeo produzido, as notificações de evento transcodificação de vídeo de definição única concluída e transcodificação de vídeo de todas as definições concluída são enviadas.
Você também pode adicionar efeitos ao vídeo produzido. Para obter mais detalhes, consulte Efeitos.

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:ProduceEditingProjectVideo

create

*全部资源

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ProjectId	string	Não	O ID do projeto de edição online. Você pode obter o ID usando um dos seguintes métodos: Faça logon no console do ApsaraVideo VOD, escolha Centro de Produção > Edição de Vídeo e visualize o ID. Obtenha o valor do parâmetro ProjectId retornado ao chamar a operação CreateEditingProject.	fb2101bf24b4cb318787dc****
Timeline	string	Não	A linha do tempo do projeto de edição online no formato JSON. Para obter mais informações sobre a estrutura, consulte Timeline. Nota Certifique-se de que cada objeto VideoTrackClip contenha um MediaId válido. Caso contrário, a solicitação falhará.	{"VideoTracks":[{"VideoTrackClips":[{"MediaId":"cc3308ac59615a54328bc3443**"},{"MediaId":"da87a9cff645cd88bc6d8326e4**"}]}]}
Title	string	Não	O título do projeto de edição online.	Título do Projeto de Clipe em Nuvem.
Description	string	Não	A descrição do projeto de edição online.	Descrição do projeto de clipe em nuvem.
CoverURL	string	Não	A miniatura do projeto de edição online.	https://example.aliyundoc.com/6AB4D0E1E1C7446888351****.png.
MediaMetadata	string	Não	Os metadados do vídeo produzido no formato JSON. Para obter mais informações sobre a estrutura, consulte MediaMetadata.	{"Description":"Descrição do Vídeo Sintético","Title":"Teste userData sintético"}
ProduceConfig	string	Não	A configuração de produção no formato JSON. Para obter mais informações sobre a estrutura, consulte ProduceConfig. Importante O campo StorageLocation pode ser ignorado quando a região de armazenamento de arquivos for Xangai. Ele é obrigatório quando a região de armazenamento de arquivos for outras regiões.	{"TemplateGroupId":"6d11e25ea30a4c465435c74****"}
UserData	string	Não	As configurações personalizadas no formato JSON. O comprimento máximo é de 256 caracteres. As configurações suportam callbacks de mensagem e outras configurações. Para obter mais informações sobre a estrutura, consulte UserData. Nota Para usar o callback de mensagem neste parâmetro, configure a URL de callback HTTP e selecione os tipos de evento de callback correspondentes no console. Caso contrário, as configurações de callback não entrarão em vigor.	{"Extend":{"width":1280,"id":"028a8e56b1ebf6bb7afc74****","height":720},"MessageCallback":{"CallbackURL":"https://example.aliyundoc.com/2016-08-15/proxy/httpcallback/testcallback/","CallbackType":"http"}}
AppId	string	Não	O ID do aplicativo. Valor padrão: app-1000000. Para obter mais informações, consulte Multiaplicativo.	app-****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	25818875-5F78-4AF6-D7393642CA58****
MediaId	string	O ID do vídeo produzido. Nota A operação de produção de vídeo retorna sincronamente o ID do vídeo produzido. Quando o MediaId é retornado, a produção do vídeo entrou na fase de processamento assíncrono.	006204a11bb386bb25491f95f****
ProjectId	string	O ID do projeto de edição online.	fb2101bf24b4cb318787dc****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "MediaId": "006204a11bb386bb25491f95f****",
  "ProjectId": "fb2101bf24b4cb318787dc****"
}

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.