CreateMediaConvertTask - Intelligent Media Management: Central de Documentação do Alibaba Cloud

Cria uma tarefa assíncrona de transcodificação de mídia. Esta tarefa processa arquivos de áudio e vídeo para transcodificação de mídia, concatenação de mídia, captura de quadros de vídeo e geração de GIFs animados.

Descrição da operação

Antes de chamar esta operação, certifique-se de compreender os métodos de cobrança e os preços do Intelligent Media Management.
Antes de chamar esta operação, certifique-se de que haja um projeto disponível na região atual. Para mais informações, consulte Gerenciamento de projetos.

Importante
O tempo de conclusão de uma tarefa assíncrona não é garantido.
Ao usar esta operação para transcodificação de mídia, ela processa apenas um fluxo de vídeo, áudio ou legenda por padrão. Você também pode configurar o número de fluxos a serem processados.
Ao usar esta operação para concatenação de mídia, você pode especificar no máximo 11 arquivos de mídia. Os parâmetros para operações como transcodificação de mídia e captura de quadros aplicam-se à saída concatenada final.
Esta operação é assíncrona. Após o início de uma tarefa, suas informações são retidas por apenas 7 dias. Após esse período, você não poderá recuperá-las. Para visualizar as informações da tarefa, chame a operação GetTask ou ListTasks com o TaskId retornado. Você também pode definir o parâmetro Notification para receber informações da tarefa por meio de notificações de mensagens.

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

imm:CreateMediaConvertTask

create

*Project

acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ProjectName	string	Sim	O nome do projeto. Para mais informações sobre como obter o nome do projeto, consulte Criar um projeto.	test-project
Sources	array<object>	Sim	Uma lista de arquivos de mídia. Se você fornecer mais de um arquivo, eles serão concatenados na ordem de suas URIs.
	array<object>	Não	O arquivo de mídia de origem.
URI	string	Não	A URI do OSS do objeto. A URI deve usar o formato `oss://${Bucket}/${Object}`, onde `${Bucket}` é o nome de um bucket do OSS na mesma região do projeto, e `${Object}` é o caminho completo para o objeto, incluindo sua extensão de arquivo.	oss://test-bucket/test-object
StartTime	number	Não	O horário de início da transcodificação de mídia, em segundos. Os valores válidos incluem: 0 (padrão): A transcodificação começa do início do arquivo de mídia. n (um valor maior que 0): A transcodificação começa n segundos após o início do arquivo de mídia.	0
Duration	number	Não	A duração da transcodificação de mídia em segundos. O valor padrão, 0, transcodifica a mídia até o seu fim.	0
Subtitles	array<object>	Não	Uma lista de legendas a serem adicionadas.
	object	Não	As configurações da legenda.
URI	string	Não	A URI do OSS do objeto. A URI deve usar o formato `oss://${Bucket}/${Object}`, onde `${Bucket}` é o nome de um bucket do OSS na mesma região do projeto, e `${Object}` é o caminho completo para o objeto, incluindo sua extensão de arquivo. Os formatos de legenda suportados incluem: srt, vtt, mov_text, ass, dvd_sub e pgs.	oss://test-bucket/test-object
TimeOffset	number	Não	O atraso da legenda, em segundos. O valor padrão é 0.	10.5
Language	string	Não	O idioma da legenda. O valor deve estar em conformidade com o padrão ISO 639-2.	eng
Attached	boolean	Não	Se true, adiciona o arquivo de mídia de origem atual à saída como um fluxo de áudio ou fluxo de vídeo sincronizado. O padrão é false. Nota Você não pode definir Attached como true para o arquivo de mídia de origem referenciado por AlignmentIndex.	false
AlignMode	string	Não	O modo de alinhamento para os fluxos de áudio e vídeo adicionados. Os valores válidos incluem: false (padrão): Nenhum alinhamento é realizado. loop: Alinha o conteúdo repetindo o áudio ou vídeo em loop. pad: Alinha o conteúdo preenchendo com quadros silenciosos ou quadros pretos. Nota Este parâmetro só entra em vigor se Attached estiver definido como true.	false
DisableVideo	boolean	Não	Especifica se deve desativar o vídeo do arquivo de mídia de origem. Os valores válidos incluem: true: Desativa o vídeo. false (padrão): Inclui o vídeo.	false
DisableAudio	boolean	Não	Especifica se deve desativar o áudio do arquivo de mídia de origem. Os valores válidos incluem: true: Desativa o áudio. false (padrão): Inclui o áudio.	false
Targets	array<object>	Não	Uma lista de tarefas de processamento de mídia.
	array<object>	Não	As configurações para um arquivo de mídia de saída.
URI	string	Não	A URI do OSS do arquivo de saída para transcodificação de mídia. A URI deve estar no formato `oss://${Bucket}/${Object}`. Neste formato, `${Bucket}` é o nome do bucket do OSS, que deve estar na mesma região do projeto, e `${Object}` é o caminho completo para o objeto, incluindo a extensão do arquivo. Se a URI tiver uma extensão de arquivo, todos os arquivos de mídia de saída serão salvos nesta URI. Se vários arquivos forem gerados, eles se substituirão. Se a URI não tiver uma extensão de arquivo, a URI de saída final será gerada com base nos parâmetros URI, Container e Segment. Por exemplo, se a URI for `oss://examplebucket/outputVideo`: Se Container for `mp4` e Segment estiver vazio, a URI do OSS do arquivo de mídia gerado será `oss://examplebucket/outputVideo.mp4`. Se Container for `ts` e Format em Segment for `hls`, o processo gerará um arquivo m3u8 com a URI do OSS `oss://examplebucket/outputVideo.m3u8` e vários arquivos TS com o prefixo `oss://examplebucket/outputVideo`.	oss://test-bucket/test-target-object.mp4
Container	string	Não	O tipo de contêiner de mídia. Os tipos de contêiner válidos incluem: Contêineres de áudio/vídeo: mp4, mkv, mov, asf, avi, mxf, ts, flv Contêineres apenas de áudio: mp3, aac, flac, oga, ac3, opus Importante Os parâmetros `Container` e `URI` devem ser definidos juntos. Para realizar apenas extração de legendas, captura de quadros, geração de sprites ou geração de imagens animadas, deixe `Container` e `URI` vazios. Neste caso, parâmetros como `Segment`, `Video`, `Audio` e `Speed` são ignorados.	mp4
Speed	number	Não	A velocidade de reprodução da mídia de saída. O valor deve estar entre 0,5 e 1,0, inclusive. O valor padrão é 1,0. Nota Este parâmetro especifica a velocidade de reprodução padrão do arquivo de saída como uma proporção da velocidade do arquivo de origem. Ele não realiza transcodificação de aceleração.	1.0
Segment	object	Não	Configurações para segmentação de mídia.
Format	string	Não	O método de segmentação. Os valores válidos incluem: hls dash	hls
Duration	number	Não	A duração de cada segmento, em segundos.	30
StartNumber	integer	Não	O número de sequência inicial. Este parâmetro é suportado apenas para HLS. O valor padrão é 0.	5
Video	TargetVideo	Não	Os parâmetros de processamento de vídeo. Importante Se este parâmetro for deixado vazio, o primeiro fluxo de vídeo, se existir, será copiado diretamente para o arquivo de saída.
Audio	TargetAudio	Não	Os parâmetros de processamento de áudio. Importante Se este parâmetro for deixado vazio, o primeiro fluxo de áudio, se existir, será copiado diretamente para o arquivo de saída.
Subtitle	TargetSubtitle	Não	Os parâmetros de processamento de legendas. Importante Se este parâmetro for deixado vazio, o primeiro fluxo de legendas, se existir, será copiado diretamente para o arquivo de saída.
Image	TargetImage	Não	Os parâmetros para captura de quadros, geração de sprites e geração de imagens animadas.
StripMetadata	boolean	Não	Se true, remove metadados como `title` e `album` do arquivo de mídia. O padrão é false.
Data	object	Não	Configurações para retenção de fluxos de dados. Importante A retenção de fluxos de dados é suportada apenas quando o parâmetro `Container` está definido como `mp4`.
Stream	array	Não	Uma lista de índices dos fluxos de dados no arquivo de origem a serem processados. Uma lista vazia (padrão) indica que nenhum fluxo de dados é retido. Um índice de -1 indica que todos os fluxos de dados são retidos. Exemplo: `[0,1]` processa os fluxos de dados com índice 0 e 1; `[1]` processa o fluxo de dados com índice 1; `[-1]` processa todos os fluxos de dados. Nota Se um índice especificado não corresponder a um fluxo de dados existente, ele será ignorado.
	integer	Não	O índice do fluxo de dados a ser processado.	0
AttachedPicture	object	Não	Configurações para retenção de imagens anexadas. Importante A retenção de imagens anexadas é suportada apenas quando o parâmetro `Container` está definido como `mp4` ou `mkv`.
Stream	array	Não	Uma lista de índices das imagens anexadas no arquivo de origem a serem processadas. Uma lista vazia (padrão) indica que nenhuma imagem anexada é retida. Um índice de -1 indica que todas as imagens anexadas são retidas. Exemplo: `[0,1]` processa as imagens anexadas com índice 0 e 1; `[1]` processa a imagem anexada com índice 1; `[-1]` processa todas as imagens anexadas. Nota Se um índice especificado não corresponder a uma imagem anexada existente, ele será ignorado.
	integer	Não	O índice da imagem anexada a ser processada.	0
UserData	string	Não	Os dados personalizados do usuário. Esses dados são retornados na notificação assíncrona, permitindo que você associe a notificação ao seu sistema interno. O comprimento máximo é de 2.048 bytes.	{"ID": "testuid","Name": "test-user","Avatar": "http://test.com/testuid"}
Tags	object	Não	Tags personalizadas para pesquisa e filtragem de tarefas assíncronas.	{"test":"val1"}
CredentialConfig	CredentialConfig	Não	Você pode deixar este parâmetro vazio se não tiver requisitos especiais. A configuração de autorização em cadeia. Para mais informações, consulte Usar autorização em cadeia para acessar recursos de outras entidades.
Notification	Notification	Não	As configurações de notificação de mensagens. Para mais informações, clique em Notification. Para informações sobre o formato das notificações assíncronas, consulte Formato de notificação assíncrona.
AlignmentIndex	integer	Não	Ao concatenar arquivos de mídia, isso especifica o índice do arquivo principal na lista Sources. Os parâmetros padrão de transcodificação (como resolução e taxa de quadros dos objetos `Video` e `Audio`) são obtidos deste arquivo principal. O índice padrão é 0.	0
TargetGroups	array<object>	Não	Uma lista de tarefas de empacotamento de mídia para converter e empacotar a mídia de entrada em saídas HLS. Cada TargetGroup corresponde a uma playlist mestre HLS.
	array<object>	Não
URI	string	Não	A URI do OSS do arquivo de playlist mestre HLS de saída para a tarefa de empacotamento.	oss://test-bucket/test-object/master.m3u8
Targets	array<object>	Não	Uma lista de subtarefas de empacotamento de mídia. Cada `Target` corresponde a um fluxo variante (`#EXT-X-STREAM-INF`) na playlist mestre HLS e gera uma playlist de mídia HLS correspondente.
	array<object>	Não
URI	string	Não	A URI do OSS do arquivo de playlist de mídia HLS de saída para a subtarefa. Importante Esta URI deve estar no mesmo diretório ou em um subdiretório de `TargetGroups.URI`.	oss://test-bucket/test-target-object.mp4
Container	string	Não	O tipo de contêiner de empacotamento. Apenas `mp4` e `ts` são suportados.	mp4
Speed	number	Não	A velocidade de reprodução da mídia de saída. O valor deve estar entre 0,5 e 1,0, inclusive. O valor padrão é 1,0. Nota Este parâmetro especifica a velocidade de reprodução padrão do arquivo de saída como uma proporção da velocidade do arquivo de origem. Ele não realiza transcodificação de aceleração.	1.0
Segment	object	Não	As configurações de empacotamento de mídia.
Format	string	Não	The media packaging format. Only `hls` is supported.	hls
Duration	number	Não	The duration of each segment, in seconds.	30
StartNumber	integer	Não	The starting sequence number for segments. The default is 0.	5
Video	TargetVideo	Não	Os parâmetros de processamento de vídeo. Importante Se este parâmetro for deixado vazio, o primeiro fluxo de vídeo, se existir, será copiado diretamente para o arquivo de saída.
Audio	TargetAudio	Não	Os parâmetros de processamento de áudio. Importante Se este parâmetro for deixado vazio, o primeiro fluxo de áudio, se existir, será copiado diretamente para o arquivo de saída.
Subtitle	TargetSubtitle	Não	Os parâmetros de processamento de legendas. Importante Você deve usar o parâmetro `Subtitle.ExtractSubtitle` para empacotar fluxos de legendas. A `URI` em `Subtitle.ExtractSubtitle` deve estar no mesmo diretório ou em um subdiretório de `TargetGroups.URI`. O `Format` em `Subtitle.ExtractSubtitle` deve ser `vtt`. Você só precisa configurar este parâmetro em um `Target` para empacotar todos os fluxos de legendas.
StripMetadata	boolean	Não	Se true, remove metadados do arquivo de saída. O padrão é false.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O corpo da resposta.
RequestId	string	O ID da solicitação.	CA995EFD-083D-4F40-BE8A-BDF75FFFE0B6
EventId	string	O ID do evento.	0ED-1Bz8z71k5TtsUejT4UJ16Es****
TaskId	string	O ID da tarefa.	MediaConvert-adb1ee28-c4c9-42a7-9f54-3b8eadcb****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "CA995EFD-083D-4F40-BE8A-BDF75FFFE0B6",
  "EventId": "0ED-1Bz8z71k5TtsUejT4UJ16Es****",
  "TaskId": "MediaConvert-adb1ee28-c4c9-42a7-9f54-3b8eadcb****"
}

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.