Envia um trabalho de transcodificação. Quando as tarefas e os fluxos de trabalho de transcodificação criados no console não atendem aos seus cenários de negócios, você pode chamar a operação SubmitJobs para realizar a transcodificação conforme necessário. Configure os parâmetros de transcodificação necessários com base na sua lógica de negócios.
Descrição da operação
-
Um trabalho de transcodificação é um trabalho assíncrono e seu tempo de conclusão não é garantido. Após enviar um trabalho de transcodificação, o trabalho é adicionado a uma fila do ApsaraVideo Media Processing (MPS) para agendamento e execução. Portanto, quando a operação retornar, a transcodificação pode não estar concluída. Após a conclusão do trabalho, chame a operação Consultar trabalhos de transcodificação para consultar o resultado da execução ou anexe uma mensagem do Message Service (MNS) à fila do MPS para receber o resultado da execução. Para obter mais informações, consulte Receber notificações de mensagens.
-
O tamanho máximo de um único arquivo de entrada é de 100 GB. Se o tamanho exceder 100 GB, o trabalho poderá falhar.
-
Para transcodificar um arquivo de entrada usando um modelo inteligente predefinido, você deve primeiro chamar a operação que envia um trabalho de análise de modelo predefinido (SubmitAnalysisJob). Após o sucesso do trabalho de análise, você pode chamar a operação que consulta trabalhos de análise de modelo (QueryAnalysisJobList) para obter a lista de modelos predefinidos disponíveis para o arquivo de entrada. Ao enviar um trabalho de transcodificação, as configurações do parâmetro TemplateId devem ser um ID de modelo predefinido disponível. Se o modelo especificado no trabalho de transcodificação enviado não estiver na lista de modelos predefinidos disponíveis, o trabalho de transcodificação falhará.
-
Para transcodificar um arquivo de entrada usando um modelo estático predefinido, não é necessário enviar um trabalho de análise de modelo.
-
Se você precisar usar várias contas no MPS, poderá criar um usuário do Resource Access Management (RAM) para sua conta Alibaba Cloud e conceder permissões ao usuário. Para obter mais informações, consulte Criar um usuário do RAM e conceder permissões. Se você usar contas diferentes da Alibaba Cloud para enviar e consultar um trabalho de transcodificação, a consulta não retornará dados.
-
Para obter mais perguntas frequentes sobre transcodificação, consulte Perguntas frequentes sobre o ApsaraVideo Media Processing.
Limite de QPS
O limite de consultas por segundo (QPS) por usuário para esta operação é de 100 solicitações por segundo. Se você exceder esse limite, as chamadas de API serão limitadas. Isso pode afetar seus negócios. Chame esta operação conforme necessário. Para obter mais informações, consulte Limite de QPS.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
mts:SubmitJobs |
create |
*Todos os recursos.
|
Nenhuma | Nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| Input |
string |
Sim |
A entrada do trabalho. Para obter mais informações, consulte Detalhes da entrada. Nota
|
{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"example.flv","Referer": "OSS anti-theft chain parameters set by the user in the OSS console"} |
| Outputs |
string |
Sim |
As configurações de saída do trabalho. Para obter mais informações, consulte Detalhes da saída.
|
[{"OutputObject":"exampleOutput.mp4","TemplateId":"6181666213ab41b9bc21da8ff5ff****","WaterMarks":[{"InputFile":{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"image_01.png"},"WaterMarkTemplateId":"9b772ce2740d4d55876d8b542d47****"}],"UserData":"testid-001"}] |
| OutputBucket |
string |
Sim |
O bucket do OSS onde o arquivo de saída é armazenado.
|
exampleBucket |
| OutputLocation |
string |
Não |
A região (região do OSS) do bucket do OSS onde o arquivo de saída é armazenado.
|
oss-cn-hangzhou |
| PipelineId |
string |
Sim |
O ID da fila do ApsaraVideo Media Processing (MPS). Para obter mais informações, consulte Termos.
|
dd3dae411e704030b921e52698e5**** |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
Os parâmetros de resposta. |
||
| JobResultList |
object |
||
| JobResult |
array<object> |
A lista de resultados de trabalhos de transcodificação enviados. |
|
|
array<object> |
O resultado do trabalho. |
||
| Code |
string |
O código de erro retornado quando o trabalho falha ao ser criado. Este parâmetro não é retornado se o trabalho for criado. |
InvalidParameter.NullValue |
| Job |
object |
Os detalhes do trabalho. Se o envio falhar, nenhum ID de trabalho será gerado. |
|
| Code |
string |
O código de erro retornado quando a transcodificação falha. Este parâmetro não é retornado se a transcodificação for bem-sucedida. |
InternalError |
| CreationTime |
string |
A hora em que o trabalho foi adicionado. A hora é exibida em UTC e segue o padrão ISO 8601 no formato YYYY-MM-DDTHH:mm:ssZ. |
2014-01-10T12:00:00Z |
| FinishTime |
string |
A hora em que o trabalho foi concluído. A hora é exibida em UTC e segue o padrão ISO 8601 no formato YYYY-MM-DDTHH:mm:ssZ. |
2014-01-10T12:20:00Z |
| Input |
object |
A entrada do trabalho. |
|
| Bucket |
string |
O bucket do OSS da entrada do trabalho. |
example-bucket-**** |
| Location |
string |
A localização do OSS da entrada do trabalho. |
oss-cn-hangzhou |
| Object |
string |
O objeto do OSS da entrada do trabalho. |
example.flv |
| JobId |
string |
O ID do trabalho. |
31fa3c9ca8134f9cec2b4b0b0f78**** |
| MNSMessageResult |
object |
O resultado da mensagem da notificação do MNS para a conclusão do trabalho. |
|
| ErrorCode |
string |
O código de erro retornado quando a notificação falha. Este parâmetro não é retornado se a notificação for bem-sucedida. |
InvalidParameter.ResourceNotFound |
| ErrorMessage |
string |
A mensagem de erro retornada quando a notificação falha. Este parâmetro não é retornado se a notificação for bem-sucedida. |
The resource operated "%s" cannot be found. |
| MessageId |
string |
O ID da mensagem de falha retornada quando a notificação falha. Este parâmetro não é retornado se a notificação for bem-sucedida. |
123 |
| Message |
string |
A mensagem retornada quando a transcodificação falha. Este parâmetro não é retornado se a transcodificação for bem-sucedida. |
The operation has failed due to some unknown error, exception or failure. |
| Output |
object |
A saída do trabalho. |
|
| AmixList |
object |
||
| Amix |
array<object> |
A lista de mixagem de áudio. |
|
|
object |
Os parâmetros de resposta. |
||
| AmixURL |
string |
A mídia da faixa de áudio de fundo a ser mixada.
|
https://outpu***.oss-cn-shanghai.aliyuncs.com/mp4-to-mp3%5E1571025263578816%40.mp3 |
| Duration |
string |
A duração. O valor pode ser um número ou estar no formato de hora. |
20 |
| Map |
string |
A faixa de áudio de destino selecionada de AmixURL. O formato do valor é 0:a:{audio_index}, como 0:a:0. |
0:a:0 |
| MixDurMode |
string |
O modo de duração da mídia. Valores válidos: first e long.
|
long |
| Start |
string |
A hora de início. O valor pode ser um número ou estar no formato de hora, como "1:25:36.240" ou "32000.23". |
0 |
| Audio |
object |
As configurações de áudio. Nota
Se as configurações de áudio forem especificadas nos parâmetros da solicitação, elas substituirão os parâmetros correspondentes no modelo de transcodificação especificado. |
|
| Bitrate |
string |
A taxa de bits de áudio do arquivo de saída.
|
128 |
| Channels |
string |
O número de canais de som.
|
6 |
| Codec |
string |
O formato de codec de áudio.
|
aac |
| Profile |
string |
O perfil de codificação de áudio. Nota
Se Codec estiver definido como aac, os valores válidos são aac_low, aac_he, aac_he_v2, aac_ld e aac_eld. |
aac_low |
| Qscale |
string |
O fator de controle de qualidade de áudio. |
15 |
| Samplerate |
string |
A taxa de amostragem.
Nota
Se o formato do contêiner de vídeo for flv e o formato do codec de áudio for mp3, as taxas de amostragem 32000, 48000 e 96000 não são suportadas. Se o formato do codec de áudio for mp3, a taxa de amostragem 96000 não é suportada. |
32000 |
| Volume |
object |
As configurações de controle de volume. |
|
| Level |
string |
O nível de ajuste de volume.
|
-20 |
| Method |
string |
O método de ajuste de volume. Valores válidos:
|
auto |
| AudioStreamMap |
string |
O índice do fluxo de áudio.
|
0:a:0 |
| Clip |
object |
O clipe. |
|
| TimeSpan |
object |
O intervalo de tempo do clipe. |
|
| Duration |
string |
A duração.
|
01:00:59.999 |
| Seek |
string |
A hora de início.
|
01:59:59.999 |
| Container |
object |
O contêiner. |
|
| Format |
string |
O formato do contêiner.
|
flv |
| DeWatermark |
string |
As configurações de desfoque. Este é um objeto JSON. Para mais informações, consulte Detalhes do desfoque em Detalhes dos parâmetros. |
{"0": [{"l": 10,"t": 10,"w": 10,"h": 10},{"l": 100,"t": 0.1,"w": 10,"h": 10}],"128000": [],"250000": [{"l": 0.2,"t": 0.1,"w": 0.01,"h": 0.05}]} |
| DigiWaterMark |
object |
A marca d'água digital. |
|
| Alpha |
string |
A transparência do texto ou da imagem.
|
1.0 |
| InputFile |
object |
O arquivo de entrada. |
|
| Bucket |
string |
O bucket do OSS do arquivo de entrada. |
example-bucket-**** |
| Location |
string |
A localização do OSS do arquivo de entrada. |
oss-cn-hangzhou |
| Object |
string |
O objeto do OSS do arquivo de entrada. |
example-intput.flv |
| Type |
string |
O tipo de marca d'água. Se o tipo de marca d'água for definido, este valor substituirá o parâmetro correspondente no modelo de marca d'água. Valores válidos:
|
Image |
| Encryption |
object |
As configurações de criptografia de dados. Apenas o formato de saída m3u8 é suportado. |
|
| Id |
string |
O ID de criptografia. |
31fa3c9ca8134f9cec2b4b0b0f78**** |
| Key |
string |
A chave usada para criptografar o vídeo. |
encryptionkey128 |
| KeyType |
string |
A chave não pode ser transmitida para o ApsaraVideo Media Processing em texto simples e deve ser criptografada usando Base64 ou KMS. Por exemplo, se a chave for "encryptionkey128", use Base64("encryptionkey128") ou KMS(Base64("encryptionkey128")). |
Base64 |
| KeyUri |
string |
A URL de acesso da chave, codificada em Base64. |
https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/ |
| SkipCnt |
string |
O número de segmentos iniciais que não são criptografados, o que permite que o vídeo comece a ser reproduzido rapidamente. |
3 |
| Type |
string |
O tipo de criptografia. Valor válido: hls-aes-128. |
hls-aes-128 |
| M3U8NonStandardSupport |
object |
As configurações de suporte para M3U8 não padrão. Este é um objeto JSON. Para mais informações, consulte Detalhes do suporte a parâmetros M3U8 não padrão em Detalhes dos parâmetros. |
|
| TS |
object |
As configurações de suporte para arquivos TS não padrão. Este é um objeto JSON. Para mais informações, consulte Detalhes do suporte a parâmetros TS em Detalhes dos parâmetros. |
|
| Md5Support |
boolean |
Especifica se há suporte para gerar o valor de hash MD5 do arquivo TS no arquivo M3U8. Valores válidos:
|
true |
| SizeSupport |
boolean |
Especifica se há suporte para gerar o tamanho do arquivo TS no arquivo M3U8. Valores válidos:
|
true |
| MergeConfigUrl |
string |
Você pode especificar apenas um dos parâmetros MergeList e MergeConfigUrl.
|
`{"MergeList":[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4"}]} |
| MergeList |
object |
||
| Merge |
array<object> |
As configurações de mesclagem de vídeo. |
|
|
object |
As configurações detalhadas de mesclagem de vídeo. |
||
| Duration |
string |
A duração.
|
00000.20 |
| MergeURL |
string |
A URL do segmento mesclado.
|
http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example-object-****.flv |
| RoleArn |
string |
As informações de função usadas para autorização. |
acs:ram:: |
| Start |
string |
A hora de início.
|
00000.50 |
| MuxConfig |
object |
As configurações de multiplexação de transcodificação. Se este parâmetro for definido nos parâmetros da solicitação, ele substituirá os parâmetros correspondentes no modelo de transcodificação especificado. |
|
| Gif |
object |
As configurações de multiplexação para GIF. |
|
| DitherMode |
string |
O modo de dithering de cores da paleta. Valores válidos: sierra e bayer. |
bayer |
| FinalDelay |
string |
O tempo de pausa do quadro final. Unidade: centissegundos. |
0 |
| IsCustomPalette |
string |
Especifica se deve ser usada uma paleta personalizada. Valores válidos:
|
false |
| Loop |
string |
O número de loops. |
0 |
| Segment |
object |
As configurações de segmento. Este é um objeto JSON. |
|
| Duration |
string |
A duração do segmento. O valor é um número inteiro. Unidade: segundos.
|
20 |
| Webp |
object |
As configurações de multiplexação para WebP. |
|
| Loop |
string |
O número de loops. |
0 |
| OpeningList |
object |
||
| Opening |
array<object> |
A lista de aberturas. Este é um objeto JSON. |
|
|
object |
Os parâmetros de resposta. |
||
| Height |
string |
A altura. Valores válidos: 0 a 4096, -1 e full. Valor padrão: -1.
|
1080 |
| Start |
string |
O horário de início em relação ao vídeo principal. Especifica o atraso antes que o vídeo de abertura seja exibido, começando em 0. Unidade: segundos. Valor padrão: 0. |
1 |
| Width |
string |
A largura. Valores válidos: 0 a 4096, -1 e full. Valor padrão: -1.
|
1920 |
| openUrl |
string |
A URL do OSS do vídeo de abertura. |
http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv |
| OutSubtitleList |
object |
||
| OutSubtitle |
array<object> |
A lista de legendas de saída. |
|
|
array<object> |
Os detalhes da legenda de saída. |
||
| Map |
string |
A faixa de vídeo. Formato: |
0:v:0 |
| Message |
string |
A mensagem de erro retornada quando o job falha ao ser criado. Este parâmetro não é retornado se o job for criado. |
The specified parameter “%s” cannot be null. |
| OutSubtitleFile |
object |
Os detalhes do arquivo de saída. |
|
| Bucket |
string |
O bucket do OSS do arquivo de entrada. |
example-bucket-**** |
| Location |
string |
A localização do OSS do arquivo de saída. |
oss-cn-hangzhou |
| Object |
string |
O objeto do OSS do arquivo de saída. |
example-output.flv |
| RoleArn |
string |
As informações de função usadas para autorização. |
acs:ram:: |
| Success |
boolean |
Indica se o job foi bem-sucedido. Valores válidos:
|
true |
| OutputFile |
object |
O arquivo de saída. |
|
| Bucket |
string |
O bucket do OSS do arquivo de entrada. |
example-bucket-**** |
| Location |
string |
A localização do OSS do arquivo de saída. |
oss-cn-hangzhou |
| Object |
string |
O objeto do OSS do arquivo de saída. |
example-output.flv |
| RoleArn |
string |
As informações de função usadas para autorização. |
acs:ram:: |
| Priority |
string |
A prioridade do job na fila MPS correspondente. Prioridade máxima: 10. Valor padrão: 6. |
5 |
| Properties |
object |
As propriedades de mídia. |
|
| Bitrate |
string |
A taxa de bits. |
1000 |
| Duration |
string |
A duração. |
55 |
| FileFormat |
string |
O formato do arquivo. |
QuickTime / MOV |
| FileSize |
string |
O tamanho do arquivo. |
3509895 |
| Format |
object |
As informações de formato. |
|
| Bitrate |
string |
A taxa de bits total. |
1000 |
| Duration |
string |
A duração total. |
55 |
| FormatLongName |
string |
O nome longo do formato de contêiner e empacotamento. |
QuickTime / MOV |
| FormatName |
string |
O nome curto do formato de contêiner e empacotamento. Valores válidos: mov, mp4, m4a, 3gp, 3g2 e mj2. |
mov |
| NumPrograms |
string |
O número total de streams de programa. |
0 |
| NumStreams |
string |
O número total de streams de mídia. |
2 |
| Size |
string |
O tamanho do arquivo. |
3509895 |
| StartTime |
string |
O horário de início. |
0.000000 |
| Fps |
string |
A taxa de quadros, como um número. |
25 |
| Height |
string |
A altura do vídeo. |
720 |
| Streams |
object |
As informações de stream. |
|
| AudioStreamList |
object |
||
| AudioStream |
array<object> |
A lista de streams de áudio. |
|
|
object |
Os detalhes do stream de áudio. |
||
| Bitrate |
string |
A taxa de bits. |
128.806 |
| ChannelLayout |
string |
O layout de saída do canal. |
stereo |
| Channels |
string |
O número de canais. |
2 |
| CodecLongName |
string |
O nome longo do formato de codificação. |
AAC (Advanced Audio Coding) |
| CodecName |
string |
O nome curto do formato de codificação. |
aac |
| CodecTag |
string |
A marca do formato de codificação. |
0x6134706d |
| CodecTagString |
string |
O texto da marca do formato de codificação. |
mp4a |
| CodecTimeBase |
string |
A base de tempo do codec. |
1/44100 |
| Duration |
string |
A duração. |
17.159546 |
| Index |
string |
O índice do stream de áudio. Identifica a posição do stream de áudio em todos os streams de mídia. |
1 |
| Lang |
string |
O idioma. Para mais informações, consulte definições de idioma do FFmpeg e ISO-639. |
eng |
| NumFrames |
string |
O número total de quadros. |
25 |
| SampleFmt |
string |
O formato de amostra. |
fltp |
| Samplerate |
string |
A taxa de amostragem. |
44100 |
| StartTime |
string |
O horário de início. |
0.000000 |
| Timebase |
string |
A base de tempo. |
1/44100 |
| SubtitleStreamList |
object |
||
| SubtitleStream |
array<object> |
A lista de streams de legendas. |
|
|
object |
Os detalhes do stream de legendas. |
||
| Index |
string |
O índice do stream de legendas. Identifica a posição do stream de legendas em todos os streams de mídia. |
1 |
| Lang |
string |
O idioma. Para mais informações, consulte definições de idioma do FFmpeg e ISO-639. |
eng |
| VideoStreamList |
object |
||
| VideoStream |
array<object> |
A lista de streams de vídeo. |
|
|
array<object> |
Os detalhes do stream de vídeo. |
||
| AvgFPS |
string |
A taxa de quadros média. |
23.976025 |
| Bitrate |
string |
A taxa de bits. |
1496.46 |
| CodecLongName |
string |
O nome longo do formato de codificação. |
H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10 |
| CodecName |
string |
O nome curto do formato de codificação. |
h264 |
| CodecTag |
string |
A marca do formato de codificação. |
0x31637661 |
| CodecTagString |
string |
O texto da marca do formato de codificação. |
avc1 |
| CodecTimeBase |
string |
A base de tempo do codec. |
1001/48000 |
| Dar |
string |
A proporção de tela (DAR) da codificação. |
16:9 |
| Duration |
string |
A duração. |
17.225542 |
| Fps |
string |
A taxa de quadros. |
23.976025 |
| HasBFrames |
string |
Indica se existem B-frames. |
2 |
| Height |
string |
A altura da resolução de vídeo. |
720 |
| Index |
string |
O índice do stream de vídeo. Identifica a posição do stream de vídeo em todos os streams de mídia. |
0 |
| Lang |
string |
O idioma. Para mais informações, consulte definições de idioma do FFmpeg e ISO-639. |
eng |
| Level |
string |
O nível de codificação. |
51 |
| NetworkCost |
object |
O consumo de largura de banda da rede. |
|
| AvgBitrate |
string |
A taxa de bits média. |
100 |
| CostBandwidth |
string |
A largura de banda máxima consumida. |
10 |
| PreloadTime |
string |
O tempo de pré-carregamento. |
8 |
| NumFrames |
string |
O número total de quadros. |
25 |
| PixFmt |
string |
O formato de pixel. |
yuv420p |
| Profile |
string |
A predefinição de codificação. |
high |
| Sar |
string |
A proporção de aspecto da amostra. |
1:1 |
| StartTime |
string |
O horário de início. |
0.000000 |
| Timebase |
string |
A base de tempo. |
1/24000 |
| Width |
string |
A largura da resolução do vídeo. |
1280 |
| Width |
string |
A largura do vídeo. |
1280 |
| Rotate |
string |
O ângulo de rotação do vídeo no sentido horário. |
180 |
| SubtitleConfig |
object |
As informações de configuração de legendas. |
|
| ExtSubtitleList |
object |
||
| ExtSubtitle |
array<object> |
A lista de legendas externas. O valor é uma matriz JSON que contém até 4 itens. |
|
|
array<object> |
Os detalhes da legenda externa. |
||
| CharEnc |
string |
A codificação de caracteres da legenda externa. Valores válidos:
Valor padrão: auto. Nota
Se você definir este parâmetro como auto, pode ocorrer detecção incorreta. Especifique uma codificação de caracteres específica. |
UTF-8 |
| FontName |
string |
O nome da fonte usada quando as legendas externas são convertidas em legendas embutidas. Valor padrão: SimSun. Para mais informações sobre fontes, consulte Lista de fontes. |
"WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun" |
| Input |
object |
O arquivo de legenda de entrada externo. O valor é um objeto JSON. Apenas os formatos srt e ass são suportados. |
|
| Bucket |
string |
O bucket do OSS onde o arquivo de entrada está armazenado. |
example-bucket-**** |
| Location |
string |
A localização do OSS onde o arquivo de entrada está armazenado. |
oss-cn-hangzhou |
| Object |
string |
O objeto do OSS do arquivo de entrada. |
example-output.flv |
| SubtitleList |
object |
||
| Subtitle |
array<object> |
A lista de legendas. |
|
|
object |
Os parâmetros de resposta. |
||
| Map |
string |
A faixa de áudio. Formato: 0:{stream}:{stream_index}, que é 0:a:{audio_index}. O valor do stream é a, que indica um stream de áudio. O índice indica o subscrito do stream de áudio na lista de streams de áudio, começando em 0. |
0:a:0 |
| SuperReso |
object |
Especifica se a resolução segue a origem. |
|
| IsHalfSample |
string |
Especifica se devem ser obtidos parâmetros relacionados à taxa de amostragem. Valores válidos:
|
true |
| TailSlateList |
object |
||
| TailSlate |
array<object> |
A lista de slates finais. O valor é um objeto JSON. |
|
|
object |
Os parâmetros de resposta. |
||
| BgColor |
string |
A cor de fundo usada para preencher o espaço em branco quando a largura e a altura do vídeo do slate final são menores que as do vídeo principal. Valor padrão: White. Para mais valores válidos, consulte bgcolor. |
White |
| BlendDuration |
string |
A duração da transição entre o vídeo principal e o vídeo do slate final. O efeito de transição é fade-in e fade-out: o último quadro do vídeo principal é exibido enquanto o vídeo do slate final é reproduzido. O último quadro do vídeo principal escurece gradualmente e o vídeo do slate final clareia gradualmente. Unidade: segundos. Valor padrão: 0. |
2 |
| Height |
string |
A altura. Valores válidos:
Valor padrão: -1. |
1080 |
| IsMergeAudio |
boolean |
Especifica se o conteúdo de áudio do vídeo do slate final deve ser concatenado. Valores válidos:
|
false |
| Start |
string |
O horário de início. |
1 |
| TailUrl |
string |
A URL do OSS do vídeo do slate final. |
http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv |
| Width |
string |
A largura. Valores válidos:
Valor padrão: -1. |
1920 |
| TemplateId |
string |
O ID do modelo de transcodificação. |
S00000000-000010 |
| TransConfig |
object |
As configurações gerais de transcodificação. Nota
Se você definir este valor no parâmetro de solicitação, ele sobrescreverá as configurações correspondentes no modelo de transcodificação especificado. |
|
| AdjDarMethod |
string |
O método usado para reescrever a resolução. Valor padrão: none. Valores válidos:
|
crop |
| IsCheckAudioBitrate |
string |
Especifica se a taxa de bits de áudio deve ser verificada. Se a taxa de bits de áudio de saída for maior que a taxa de bits de áudio de origem, a taxa de bits de áudio de saída será considerada igual à taxa de bits de áudio de origem, e o parâmetro de taxa de bits de áudio especificado não terá efeito. A prioridade deste parâmetro é menor que a de IsCheckAudioBitrateFail. Valores válidos:
Valores padrão:
|
false |
| IsCheckAudioBitrateFail |
string |
Especifica se a taxa de bits de áudio deve ser verificada. A prioridade deste parâmetro é maior que a de IsCheckAudioBitrate. Se a taxa de bits de áudio de saída for maior que a taxa de bits de áudio de origem, o trabalho de transcodificação não será executado e uma falha de transcodificação será retornada. Valores válidos:
|
true |
| IsCheckReso |
string |
Especifica se a resolução deve ser verificada. Se a resolução de saída for maior que a resolução de entrada em largura ou altura, a resolução de saída será considerada igual à resolução de entrada. Valores válidos:
Valor padrão: false. |
false |
| IsCheckResoFail |
string |
Especifica se a resolução deve ser verificada. A prioridade deste parâmetro é maior que a de IsCheckReso. Se a resolução de saída for maior que a resolução de entrada em largura ou altura, o trabalho de transcodificação não será executado e uma falha de transcodificação será retornada. Valores válidos:
Valor padrão: false. |
false |
| IsCheckVideoBitrate |
string |
Especifica se a taxa de bits de vídeo deve ser verificada. Se a taxa de bits de vídeo de saída for maior que a taxa de bits de vídeo de entrada, a taxa de bits de vídeo de saída será considerada igual à taxa de bits de vídeo de entrada. Valores válidos:
Valor padrão: false. |
false |
| IsCheckVideoBitrateFail |
string |
Especifica se a taxa de bits de vídeo deve ser verificada. Se a taxa de bits de vídeo de saída for maior que a taxa de bits de vídeo de origem, o trabalho de transcodificação não será executado e uma falha de transcodificação será retornada. A prioridade deste parâmetro é maior que a de IsCheckVideoBitrate. Valores válidos:
Valor padrão: false. |
true |
| TransMode |
string |
O modo de transcodificação. Valores válidos:
|
onepass |
| UserData |
string |
Os dados personalizados do usuário. |
example data |
| Video |
object |
As configurações de vídeo. Nota
Se você especificar este parâmetro, ele sobrescreverá as configurações de AliyunVideoCodec no modelo especificado por TemplateId. |
|
| Bitrate |
string |
A taxa de bits do arquivo de saída. Unidade: Kbps. |
10 |
| BitrateBnd |
object |
O intervalo da taxa de bits média de vídeo. |
|
| Max |
string |
O limite superior da taxa de bits total. Unidade: Kbps. |
20 |
| Min |
string |
O limite inferior da taxa de bits total. Unidade: Kbps. |
10 |
| Bufsize |
string |
O tamanho do buffer.
|
1000 |
| Codec |
string |
O formato do codec.
|
H.264 |
| Crf |
string |
O fator de taxa constante (CRF) para controle de qualidade da taxa de bits.
|
22 |
| Crop |
string |
As configurações de recorte de vídeo. Dois métodos são suportados:
|
1280:800:0:140 |
| Degrain |
string |
A intensidade do algoritmo independente de redução de ruído. |
5 |
| Fps |
string |
A taxa de quadros.
|
60 |
| Gop |
string |
O intervalo de tempo máximo ou número máximo de quadros entre quadros-chave. Unidade: segundos.
|
1 |
| Height |
string |
A altura.
|
1280 |
| MaxFps |
string |
A taxa de quadros máxima. |
15 |
| Maxrate |
string |
A taxa de bits de pico do vídeo. Unidade: Kbps. |
10 |
| Pad |
string |
As configurações de preenchimento de vídeo para bordas pretas.
|
1280:800:0:140 |
| PixFmt |
string |
O formato de cor do vídeo.
|
yuvj420p |
| Preset |
string |
A predefinição do algoritmo de vídeo. Valor padrão: medium. Valores válidos:
|
veryfast |
| Profile |
string |
O perfil de codificação. Este parâmetro é suportado apenas pelo H.264. Valor padrão: high. Valores válidos: Nota
Se você tiver várias resoluções, defina a resolução mais baixa como baseline para garantir a reprodução em dispositivos de baixo custo. Defina outras resoluções como main ou high.
|
baseline |
| Qscale |
string |
O valor de controle de qualidade do vídeo. |
15 |
| ResoPriority |
string |
A prioridade do recurso. |
1 |
| ScanMode |
string |
O modo de varredura. Valores válidos:
Melhor prática: Embora a varredura entrelaçada economize mais dados do que a varredura progressiva, a qualidade da imagem é inferior. Portanto, a varredura progressiva é amplamente utilizada na produção de vídeo convencional.
|
interlaced |
| Width |
string |
A largura.
|
1080 |
| VideoStreamMap |
string |
O índice do stream de vídeo.
|
0:a:0 |
| WaterMarkConfigUrl |
string |
A URL do arquivo de configuração da marca d'água. |
http://example.com/configure |
| WaterMarkList |
object |
||
| WaterMark |
array<object> |
A lista de marcas d'água. Nota
Se a saída da marca d'água for truncada ou falhar, verifique se a marca d'água de texto adicionada contém caracteres especiais. Em caso afirmativo, escape os caracteres especiais antes de passá-los, ou abra um ticket para entrar em contato com o suporte técnico do Alibaba Cloud para processamento de compatibilidade. |
|
|
array<object> |
Os detalhes da marca d'água. |
||
| Dx |
string |
O deslocamento horizontal da imagem da marca d'água em relação ao vídeo de saída. Se você definir este valor no parâmetro de solicitação, ele sobrescreverá as configurações correspondentes no modelo de marca d'água. Valor padrão: 0. O valor pode estar em um dos seguintes formatos:
|
1 |
| Dy |
string |
O deslocamento vertical da imagem da marca d'água em relação ao vídeo de saída. Se você definir este valor no parâmetro de solicitação, ele sobrescreverá as configurações correspondentes no modelo de marca d'água. O valor pode estar em um dos seguintes formatos:
|
1 |
| Height |
string |
A altura da imagem da marca d'água. Se você definir este valor no parâmetro de solicitação, ele sobrescreverá as configurações correspondentes no modelo de marca d'água. O valor pode estar em um dos seguintes formatos:
|
1280 |
| InputFile |
object |
O arquivo de entrada para a marca d'água. Imagens PNG e arquivos MOV são suportados como arquivos de entrada. |
|
| Bucket |
string |
O bucket do OSS do arquivo de entrada. |
example-bucket |
| Location |
string |
A localização do OSS do arquivo de entrada. |
oss-cn-hangzhou |
| Object |
string |
O objeto do OSS do arquivo de entrada. |
example-logo-****.png |
| ReferPos |
string |
A posição da marca d'água. Se você definir este valor no parâmetro de solicitação, ele sobrescreverá as configurações correspondentes no modelo de marca d'água. Valores válidos:
|
TopRight |
| Type |
string |
O tipo da marca d'água. Se você definir este valor no parâmetro de solicitação, ele sobrescreverá as configurações correspondentes no modelo de marca d'água. Para mais informações, consulte Detalhes do parâmetro. Valores válidos:
|
Image |
| WaterMarkTemplateId |
string |
O ID do modelo de marca d'água. |
88c6ca184c0e47098a5b665e2a12**** |
| Width |
string |
A largura da imagem da marca d'água. Se este valor for definido no parâmetro de solicitação Settings, ele substituirá a largura da imagem da marca d'água especificada no modelo de marca d'água. O valor pode estar em um dos seguintes formatos:
|
1080 |
| Percent |
integer |
O progresso da transcodificação. |
100 |
| PipelineId |
string |
O ID da fila do MPS. |
88c6ca184c0e47098a5b665e2a126797 |
| State |
string |
O status do job.
|
Submitted |
| Message |
string |
A mensagem de erro retornada quando o job falha ao ser criado. Este parâmetro não é retornado quando o job é criado com sucesso. |
The specified parameter "%s" cannot be null. |
| Success |
boolean |
Indica se o job foi bem-sucedido. Valores válidos:
|
true |
| RequestId |
string |
O ID da solicitação. |
25818875-5F78-4A45S71F6-D73936451234 |
Exemplos
Resposta de sucesso
JSON formato
{
"JobResultList": {
"JobResult": [
{
"Code": "InvalidParameter.NullValue",
"Job": {
"Code": "InternalError",
"CreationTime": "2014-01-10T12:00:00Z",
"FinishTime": "2014-01-10T12:20:00Z",
"Input": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example.flv"
},
"JobId": "31fa3c9ca8134f9cec2b4b0b0f78****",
"MNSMessageResult": {
"ErrorCode": "InvalidParameter.ResourceNotFound",
"ErrorMessage": "The resource operated \"%s\" cannot be found.",
"MessageId": "123"
},
"Message": "The operation has failed due to some unknown error, exception or failure.",
"Output": {
"AmixList": {
"Amix": [
{
"AmixURL": "https://outpu***.oss-cn-shanghai.aliyuncs.com/mp4-to-mp3%5E1571025263578816%40.mp3",
"Duration": "20",
"Map": "0:a:0",
"MixDurMode": "long",
"Start": "0"
}
]
},
"Audio": {
"Bitrate": "128",
"Channels": "6",
"Codec": "aac",
"Profile": "aac_low",
"Qscale": "15",
"Samplerate": "32000",
"Volume": {
"Level": "-20",
"Method": "auto"
}
},
"AudioStreamMap": "0:a:0",
"Clip": {
"TimeSpan": {
"Duration": "01:00:59.999",
"Seek": "01:59:59.999"
}
},
"Container": {
"Format": "flv"
},
"DeWatermark": "{\"0\": [{\"l\": 10,\"t\": 10,\"w\": 10,\"h\": 10},{\"l\": 100,\"t\": 0.1,\"w\": 10,\"h\": 10}],\"128000\": [],\"250000\": [{\"l\": 0.2,\"t\": 0.1,\"w\": 0.01,\"h\": 0.05}]}",
"DigiWaterMark": {
"Alpha": "1.0",
"InputFile": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example-intput.flv"
},
"Type": "Image"
},
"Encryption": {
"Id": "31fa3c9ca8134f9cec2b4b0b0f78****",
"Key": "encryptionkey128",
"KeyType": "Base64",
"KeyUri": "https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/",
"SkipCnt": "3",
"Type": "hls-aes-128"
},
"M3U8NonStandardSupport": {
"TS": {
"Md5Support": true,
"SizeSupport": true
}
},
"MergeConfigUrl": "`{\"MergeList\":[{\"MergeURL\":\"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4\"}]}",
"MergeList": {
"Merge": [
{
"Duration": "00000.20",
"MergeURL": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example-object-****.flv",
"RoleArn": "acs:ram:::role/",
"Start": "00000.50"
}
]
},
"MuxConfig": {
"Gif": {
"DitherMode": "bayer",
"FinalDelay": "0",
"IsCustomPalette": "false",
"Loop": "0"
},
"Segment": {
"Duration": "20"
},
"Webp": {
"Loop": "0"
}
},
"OpeningList": {
"Opening": [
{
"Height": "1080",
"Start": "1",
"Width": "1920",
"openUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv"
}
]
},
"OutSubtitleList": {
"OutSubtitle": [
{
"Map": "0:v:0",
"Message": "The specified parameter “%s” cannot be null.",
"OutSubtitleFile": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example-output.flv",
"RoleArn": "acs:ram:::role/"
},
"Success": true
}
]
},
"OutputFile": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example-output.flv",
"RoleArn": "acs:ram:::role/"
},
"Priority": "5",
"Properties": {
"Bitrate": "1000",
"Duration": "55",
"FileFormat": "QuickTime / MOV",
"FileSize": "3509895",
"Format": {
"Bitrate": "1000",
"Duration": "55",
"FormatLongName": "QuickTime / MOV",
"FormatName": "mov",
"NumPrograms": "0",
"NumStreams": "2",
"Size": "3509895",
"StartTime": "0.000000"
},
"Fps": "25",
"Height": "720",
"Streams": {
"AudioStreamList": {
"AudioStream": [
{
"Bitrate": "128.806",
"ChannelLayout": "stereo",
"Channels": "2",
"CodecLongName": "AAC (Advanced Audio Coding)",
"CodecName": "aac",
"CodecTag": "0x6134706d",
"CodecTagString": "mp4a",
"CodecTimeBase": "1/44100",
"Duration": "17.159546",
"Index": "1",
"Lang": "eng",
"NumFrames": "25",
"SampleFmt": "fltp",
"Samplerate": "44100",
"StartTime": "0.000000",
"Timebase": "1/44100"
}
]
},
"SubtitleStreamList": {
"SubtitleStream": [
{
"Index": "1",
"Lang": "eng"
}
]
},
"VideoStreamList": {
"VideoStream": [
{
"AvgFPS": "23.976025",
"Bitrate": "1496.46",
"CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
"CodecName": "h264",
"CodecTag": "0x31637661",
"CodecTagString": "avc1",
"CodecTimeBase": "1001/48000",
"Dar": "16:9",
"Duration": "17.225542",
"Fps": "23.976025",
"HasBFrames": "2",
"Height": "720",
"Index": "0",
"Lang": "eng",
"Level": "51",
"NetworkCost": {
"AvgBitrate": "100",
"CostBandwidth": "10",
"PreloadTime": "8"
},
"NumFrames": "25",
"PixFmt": "yuv420p",
"Profile": "high",
"Sar": "1:1",
"StartTime": "0.000000",
"Timebase": "1/24000",
"Width": "1280"
}
]
}
},
"Width": "1280"
},
"Rotate": "180",
"SubtitleConfig": {
"ExtSubtitleList": {
"ExtSubtitle": [
{
"CharEnc": "UTF-8",
"FontName": "\"WenQuanYi Zen Hei\", \"Yuanti SC Regular\", \"SimSun\"",
"Input": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example-output.flv"
}
}
]
},
"SubtitleList": {
"Subtitle": [
{
"Map": "0:a:0"
}
]
}
},
"SuperReso": {
"IsHalfSample": "true"
},
"TailSlateList": {
"TailSlate": [
{
"BgColor": "White",
"BlendDuration": "2",
"Height": "1080",
"IsMergeAudio": false,
"Start": "1",
"TailUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv",
"Width": "1920"
}
]
},
"TemplateId": "S00000000-000010",
"TransConfig": {
"AdjDarMethod": "crop",
"IsCheckAudioBitrate": "false",
"IsCheckAudioBitrateFail": "true",
"IsCheckReso": "false",
"IsCheckResoFail": "false",
"IsCheckVideoBitrate": "false",
"IsCheckVideoBitrateFail": "true",
"TransMode": "onepass"
},
"UserData": "example data",
"Video": {
"Bitrate": "10",
"BitrateBnd": {
"Max": "20",
"Min": "10"
},
"Bufsize": "1000",
"Codec": "H.264",
"Crf": "22",
"Crop": "1280:800:0:140",
"Degrain": "5",
"Fps": "60",
"Gop": "1",
"Height": "1280",
"MaxFps": "15",
"Maxrate": "10",
"Pad": "1280:800:0:140",
"PixFmt": "yuvj420p",
"Preset": "veryfast",
"Profile": "baseline",
"Qscale": "15",
"ResoPriority": "1",
"ScanMode": "interlaced",
"Width": "1080"
},
"VideoStreamMap": "0:a:0",
"WaterMarkConfigUrl": "http://example.com/configure",
"WaterMarkList": {
"WaterMark": [
{
"Dx": "1",
"Dy": "1",
"Height": "1280",
"InputFile": {
"Bucket": "example-bucket",
"Location": "oss-cn-hangzhou",
"Object": "example-logo-****.png"
},
"ReferPos": "TopRight",
"Type": "Image",
"WaterMarkTemplateId": "88c6ca184c0e47098a5b665e2a12****",
"Width": "1080"
}
]
}
},
"Percent": 100,
"PipelineId": "88c6ca184c0e47098a5b665e2a126797",
"State": "Submitted"
},
"Message": "The specified parameter \"%s\" cannot be null.",
"Success": true
}
]
},
"RequestId": "25818875-5F78-4A45S71F6-D73936451234"
}
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.