Intelligent Media Services:SubmitMediaProducingJob

• Cobrança: a edição de vídeo é cobrada com base na duração do vídeo de saída. Para obter mais informações, consulte edição de vídeo(~~2840899~~). Jobs com falha não incorrem em cobranças.

• Capacidades de edição flexíveis: use esta operação para organizar e projetar ativos. Ela suporta edição de vídeo complexa por meio de configurações flexíveis de linha do tempo(~~198823~~).

• Regras de referência de ativos: os ativos referenciados na linha do tempo podem ser ativos de mídia da sua biblioteca de ativos ou objetos do OSS. URLs externas e URLs de CDN não são suportadas. Se um ativo for um objeto do OSS, MediaUrl deve ser uma URL do OSS, por exemplo: https://seu-bucket.oss-nome-da-regiao.aliyuncs.com/seu-objeto.ext.

• Execução assíncrona de jobs: esta operação cria uma tarefa assíncrona(~~3027141~~). Após enviar um job, a operação retorna um ID de tarefa e coloca o job na fila para processamento em segundo plano. O job ainda não está concluído neste estágio. O sistema entrega o resultado final por meio de uma notificação de callback. Você também pode consultar o status do job consultando o job de edição e composição(~~441149~~).

• Consulta de status do job:

  1. Chame a operação Consultar um job de edição e composição(~~441149~~) e passe o JobId para consultar o status e o resultado do job.

  2. Ao enviar um job de edição e composição, você pode incluir uma URL de callback no parâmetro UserData da sua solicitação. Quando o job for concluído ou falhar, o sistema enviará uma notificação para esta URL de callback. Você pode usar os dados do callback para recuperar o status do job.

• Registro e análise de ativos de mídia: após a conclusão da composição de vídeo, o sistema registra automaticamente um novo ativo de mídia, que inicialmente está em estado de análise. Após a conclusão da análise, você pode usar o MediaId para recuperar a duração e a resolução do vídeo de saída.

Limitações

• O limite de limitação de taxa para esta operação é de 30 QPS. Os jobs enviados são colocados em fila e processados de forma assíncrona.

  Nota

  Se você exceder esse limite, poderá encontrar um erro Throttling.User. Para obter mais informações, consulte Erro Throttling.User ao enviar jobs de edição(~~453484~~).

• Ao enviar um grande número de jobs (por exemplo, 1.000 ou 10.000), o sistema escala horizontalmente de forma automática, mas você pode experimentar atrasos na fila.

• O número máximo de faixas é 100 para cada tipo: vídeo, imagem e legenda.

• Embora não haja limite para o número de ativos, o tamanho total deles não deve exceder 1 TB.

• A região do bucket do OSS de entrada ou saída deve corresponder à região do IMS.

• Quando a saída é um vídeo, aplicam-se os seguintes limites de resolução:

  • Tanto a largura quanto a altura devem ter pelo menos 128 px.

  • Nem a largura nem a altura podem exceder 4096 px.

  • O lado menor não pode exceder 2160 px. edição de vídeo linha do tempo tarefa assíncrona Consultar um job de edição e composição Erro "Throttling.User" ao enviar jobs de edição

Exemplos do parâmetro OutputMediaConfig

Exemplo: Saída para o OSS

{
  "MediaURL":"https://my-test-bucket.oss-cn-shanghai.aliyuncs.com/test/xxxxxtest001xxxxx.mp4",
  "Bitrate": 2000,  
  "Width": 800,  
  "Height": 680
}

Ao enviar a saída para o OSS, o parâmetro MediaURL é obrigatório. O parâmetro OutputMediaTarget tem como padrão oss-object, que envia a saída para o OSS. Outros parâmetros são opcionais. O parâmetro bitrate define a taxa de bits do arquivo de saída. Uma taxa de bits mais alta geralmente resulta em melhor qualidade, com um valor máximo de 5000 Kbps. Os parâmetros width e height definem a resolução do arquivo de saída.

O formato da URL do OSS é: https://bucketname.oss-region-name.aliyuncs.com/xxx/yyy.ext

bucketname é o nome do seu bucket do OSS.

oss-region-name.aliyuncs.com é o endpoint público para arquivos do OSS. Por exemplo, os endpoints públicos para as regiões China (Xangai), China (Pequim) e China (Hangzhou) são:

oss-cn-shanghai.aliyuncs.com
oss-cn-hangzhou.aliyuncs.com 
oss-cn-beijing.aliyuncs.com

Exemplo: Saída para o ApsaraVideo for VOD

{ 
  "StorageLocation": "outin-*xxxxxx7d2a3811eb83da00163exxxxxx.oss-cn-shanghai.aliyuncs.com",  
  "FileName": "output.mp4",  
  "Bitrate": 2000,  
  "Width": 800,  
  "Height": 680
}

Ao enviar a saída para o ApsaraVideo for VOD, os parâmetros storageLocation e FileName são obrigatórios. Defina o parâmetro OutputMediaTarget como vod-media para enviar a saída para um bucket de armazenamento do ApsaraVideo for VOD. Para encontrar locais de armazenamento disponíveis, visualize o local de armazenamento de um ativo de mídia carregado no console do ApsaraVideo for VOD.

Parâmetros em OutputMediaConfig