Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Workflows 2.0

Última atualização: Jul 10, 2026

O ApsaraVideo VOD oferece recursos de processamento de mídia, como transcodificação, snapshots e revisão automatizada. Os workflows permitem combinar esses recursos em pipelines de processamento personalizados no console.

O que é um workflow

Um workflow simplifica e modulariza as tarefas de processamento de mídia. Pré-configure um pipeline de processamento personalizado e aplique-o aos seus vídeos para eliminar chamadas repetitivas à API.

Novidades

A nova versão dos workflows inclui nós principais do ApsaraVideo VOD e adiciona nós do Intelligent Media Services (IMS) para tradução de vídeo, extração de legendas, remoção de legendas e remoção de logotipos. Também há suporte a consultas de tarefas e callbacks de tarefas de workflow. Novos nós de recursos serão adicionados para atender às necessidades empresariais em evolução.

Comparação de recursos

✔️ indica que há suporte ao recurso, ❌ indica que não há suporte e — indica que o recurso não se aplica.

Categoria

Recurso

Versão anterior

Nova versão

Nós do ApsaraVideo VOD

transcodificação de vídeo

✔️

✔️

snapshot de vídeo

✔️

✔️

animação de vídeo

✔️

✔️

revisão/desduplicação automatizada

✔️

Nós do Intelligent Media Services

tradução de vídeo

✔️

extração de legendas

✔️

remoção de legendas

✔️

remoção de logotipo

✔️

Consulta de tarefa de workflow

✔️

callback de workflow

Eventos de callback de tarefa de workflow

✔️

Configurações individuais de callback de workflow

✔️

Callback individual de tarefa de nó

✔️

Callback no nível de Media ID (userdata)

✔️

Limitações

  • Os nós de tradução de vídeo, extração de legendas e remoção de legendas estão disponíveis apenas nas regiões China (Shanghai), China (Beijing), China (Shenzhen) e Singapore. O nó de remoção de logotipo está disponível apenas nas regiões China (Shanghai), China (Beijing) e Singapore. Os nós do ApsaraVideo VOD estão disponíveis em todas as regiões.

  • Para usar os nós do ApsaraVideo VOD e do Intelligent Media Services, ative separadamente o ApsaraVideo VOD e o Intelligent Media Services.

Casos de uso

  • Serial: Tradução e transcodificação

    Este workflow traduz um vídeo e depois transcodifica a saída. Para detalhes de configuração, consulte a seção Exemplo de configuração de workflow. A configuração do nó é: Startvideo translationvideo transcodingEnd. Os dados de vídeo são transmitidos entre os nós.

  • Paralelo: Remoção de legendas e transcodificação

    Este workflow executa simultaneamente a remoção de legendas e a transcodificação. Ele se ramifica a partir do nó Start em dois caminhos paralelos: subtitle removal e video transcoding. Ambos os caminhos se fundem no nó End após a conclusão das tarefas.

  • Paralelo: Distribuição de arquivo source e transcodificação

    Este workflow distribui o arquivo source como um fluxo de reprodução enquanto o transcodifica para criar outras versões com base em um modelo de transcodificação especificado.

    Este workflow utiliza dois nós de video transcoding. Configure o nó superior com um no-transcoding template group ID para distribuir o arquivo source. Configure o nó inferior com um transcoding template group ID para gerar outras versões.

Como funciona

Antes de começar, configure um workflow no console.

  1. Especifique o ID do workflow ao solicitar uma URL de upload e credenciais. O ApsaraVideo VOD retorna a URL e as credenciais.

  2. Faça o upload do vídeo.

  3. O workflow é acionado automaticamente após a conclusão do upload.

  4. O mecanismo de workflow do ApsaraVideo VOD executa automaticamente as tarefas de processamento de mídia e de IA de vídeo conforme a configuração do workflow.

  5. Quando todas as tarefas terminam, o workflow é encerrado e o service envia uma notificação de callback.

Como usar

  1. Crie um workflow.

    Atualmente, é possível criar workflows apenas no console do ApsaraVideo VOD.

    Visualize Procedure

    1. Faça login no console do ApsaraVideo VOD.

    2. No painel de navegação à esquerda, escolha Configuration Management > Media Processing > Workflows.

    3. Clique em Add Workflow Template e insira um nome para o workflow.

    4. Clique no ícone + ao lado do nó Start para editar a topologia do workflow e clique em OK. Na área Workflow Template, clique em um nó Video no fluxograma para definir suas configurações. Se necessário, insira uma Template Description e selecione uma opção de Callback Event (Use unified callback configuration ou Use independent callback configuration). Clique em Submit.

    5. Após a criação do workflow, localize seu ID na página Workflows. Esse ID será necessário para iniciar tarefas de workflow.

  2. Inicie uma tarefa de workflow.

    É possível iniciar uma tarefa de workflow durante ou após o upload do vídeo.

    In the console

    During upload

    1. Faça login no console do ApsaraVideo VOD.

    2. No painel de navegação à esquerda, escolha Media Files > Audio/Video e clique em Upload Audio/Video.

    3. Clique em Add Audio/Video, configure parâmetros como método de upload e bucket, selecione Use Workflow e escolha seu workflow.

      Para mais informações sobre formatos de upload compatíveis e descrições de parâmetros, consulte Upload de arquivos no console.

    4. Após adicionar os arquivos de mídia a serem enviados, clique em Upload.

    After upload

    1. Faça login no console do ApsaraVideo VOD.

    2. No painel de navegação à esquerda, escolha Media Files > Audio/Video.

    3. Na lista de áudio/vídeo, localize o arquivo de mídia que deseja processar e clique em Processing na coluna Actions.

    4. Na caixa de diálogo Media Processing, selecione Use Workflow como tipo de processamento. Na lista suspensa Use Workflow, escolha o workflow desejado, como test.

    5. Clique em OK.

    Using API

    During upload

    Nota

    A operação CreateUploadVideo retorna apenas uma URL de upload, credenciais e informações básicas do ativo de mídia. Ela não faz o upload do arquivo de mídia. Implemente a lógica de upload. Para um exemplo completo de como fazer upload de arquivos usando a API, consulte Upload de arquivos de mídia chamando a API do ApsaraVideo VOD.

    1. Ao chamar a operação CreateUploadVideo ou UploadMediaByURL para enviar um arquivo de mídia, defina o parâmetro WorkflowId com o ID do seu workflow. Após a conclusão do upload, o sistema processa automaticamente o arquivo com base no workflow especificado.

    After upload

    1. Para processar um arquivo de mídia já enviado, chame a operação SubmitWorkflowJob. Defina o parâmetro WorkflowId com o ID do seu workflow para iniciar imediatamente a tarefa de processamento.

Exemplos de configuração

Tradução e transcodificação em série

Este exemplo mostra como configurar um workflow serial que traduz um vídeo e depois o transcodifica.

  1. Na página de edição de workflow, clique no ícone + à direita do nó Start para adicionar um nó de tradução de vídeo. Configure seus parâmetros no painel exibido à direita.

  2. Clique no ícone + à direita do nó de tradução para adicionar um nó de transcodificação de vídeo. No painel lateral direito, selecione um grupo de modelos de transcodificação.

    Nota

    Para obter informações sobre como configurar um grupo de modelos de transcodificação, consulte Modelos de transcodificação.

  3. Após concluir a configuração da topologia do workflow, clique em OK. O sistema gera um ID de workflow. Salve esse ID para aplicar o workflow a uploads futuros. Depois de criar o workflow, visualize-o na lista de workflows com seu nome, ID e data de criação. Na coluna Actions, clique em Details para ver a configuração do workflow ou em Delete para removê-lo.

Extração de legendas e transcodificação em paralelo

Para executar a extração de legendas e a transcodificação em paralelo, adicione dois nós filhos — extração de legendas e transcodificação de vídeo — após o nó Start. No editor de workflow, o nó Start se ramifica em dois caminhos paralelos conectados por linhas Video. O caminho superior contém o nó de subtitle extraction (VodCaptionExtraction) e o caminho inferior contém o nó de video transcoding (VodTranscode). Ambos os caminhos convergem no nó End, conectados pelas linhas Subtitle e Video, respectivamente.