AddTemplate - : Central de Documentação do Alibaba Cloud

Observações de uso

Use esta operação para definir os parâmetros relacionados ao container, aos fluxos de áudio e aos fluxos de vídeo. Se você não especificar alguns parâmetros, os fluxos gerados pelo modelo não terão as configurações correspondentes.

Limites de QPS

Esta operação permite até 100 chamadas por segundo por conta. O sistema descarta solicitações que excedem esse limite, o que pode causar interrupções no serviço. Considere esse limite ao chamar esta operação. Para mais informações, consulte Limite de QPS.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	AddTemplate	A operação a ser executada. Defina o valor como AddTemplate.
Name	String	Sim	mps-example	Nome do modelo. O nome pode ter até 128 bytes.
Container	String	Não	{"Format":"mp4"}	Configuração do container. O valor deve ser um objeto JSON e conter o parâmetro Format. Se você não configurar o container, o arquivo de mídia transcodificado estará no formato MP4 por padrão. Para gerar arquivos de mídia em outros formatos com este modelo de transcodificação, este parâmetro é obrigatório. Para mais informações, consulte a seção Parâmetro aninhado sob o parâmetro Container deste tópico. Valor padrão do parâmetro Format: mp4. Os formatos de vídeo incluem FLV, MP4, HLS (M3U8 + TS) e MPEG-DASH (MPD + fMP4). Nota Se o formato do container for FLV, o codec de vídeo não poderá ser definido como H.265. Os formatos de áudio incluem MP3, MP4, Ogg, FLAC e M4A. Os formatos de imagem incluem GIF e WebP. Nota Se o formato do container for GIF, o codec de vídeo deve ser GIF. Se o formato do container for WebP, o codec de vídeo deve ser definido como WebP.
Video	String	Não	{"Codec":"H.264","Profile":"high","Bitrate":"500","Crf":"15","Width":"256","Height":"800","Fps":"25","Gop":"10s"}	Configuração do fluxo de vídeo. O valor deve ser um objeto JSON. Para mais informações, consulte a seção Parâmetros aninhados sob o parâmetro Video deste tópico. Nota Se você não definir este parâmetro, os arquivos de saída não conterão fluxos de vídeo. Para manter os fluxos de vídeo, este parâmetro é obrigatório.
Audio	String	Não	{"Codec":"H.264","Samplerate":"44100","Bitrate":"500","Channels":"2"}	Configuração do fluxo de áudio. O valor deve ser um objeto JSON. Para mais informações, consulte a seção Parâmetros aninhados sob o parâmetro Audio deste tópico. Nota Se você não definir este parâmetro, os arquivos de saída não conterão fluxos de áudio. Para manter os fluxos de áudio, este parâmetro é obrigatório.
TransConfig	String	Não	{"TransMode":"onepass"}	Configuração geral de transcodificação. O valor deve ser um objeto JSON. Para mais informações, consulte a seção Parâmetros aninhados sob o parâmetro TransConfig deste tópico. Se você não definir este parâmetro, as configurações padrão serão utilizadas. Caso as configurações padrão não atendam às suas necessidades de transcodificação, defina os parâmetros aninhados sob TransConfig conforme necessário.
MuxConfig	String	Não	{"Segment":{"Duration":"10"}}	Configuração de segmentação. O valor deve ser um objeto JSON. Para mais informações, consulte a seção Parâmetros aninhados sob o parâmetro MuxConfig deste tópico. Se você não definir este parâmetro, arquivos de segmento de mídia não serão gerados. Para gerar arquivos de segmento de mídia, este parâmetro é obrigatório.

Parâmetro aninhado sob o parâmetro Container

Parâmetro	Tipo	Obrigatório	Descrição
Format	String	Não	Valor padrão: mp4. Os formatos de vídeo incluem FLV, MP4, HLS (M3U8 + TS) e MPEG-DASH (MPD + fMP4). Os formatos de áudio incluem MP3, MP4, Ogg, FLAC e M4A. Os formatos de imagem incluem GIF e WebP. Se você definir o formato do container como GIF ou WebP, o codec de vídeo deve ser definido respectivamente como GIF ou WebP. Se o formato do container for FLV, o codec de vídeo não poderá ser H.265.

Parâmetros aninhados sob o parâmetro Video

Parâmetro	Tipo	Obrigatório	Descrição
Codec	String	Não	Codec de vídeo. Codecs válidos: H.264, H.265, GIF e WebP. Codec padrão: H.264.
Profile	String	Não	Perfil do codec. Valores válidos: baseline, main e high. Valor padrão: high. O valor baseline indica transcodificação para dispositivos móveis. O valor main indica transcodificação para dispositivos de resolução padrão. O valor high indica transcodificação para dispositivos de alta resolução. Se houver múltiplas definições, recomenda-se definir este parâmetro como baseline para a menor definição, garantindo a reprodução normal em dispositivos básicos. Defina como main ou high para as demais definições. Este parâmetro é válido apenas quando o codec de vídeo é H.264.
Bitrate	String	Não	Taxa de bits. Valores válidos: 10 a 50000. Unidade: Kbit/s.
Crf	String	Não	Fator de taxa constante. Valores válidos: 0 a 51. Valor padrão: 26. Se este parâmetro for retornado, a configuração do parâmetro Bitrate será inválida.
Width	String	Não	Largura do vídeo. Valor padrão: largura do vídeo de entrada. Valores válidos: 128 a 4096. Unidade: pixel.
Height	String	Não	Altura do vídeo. Valor padrão: altura do vídeo de entrada. Valores válidos: 128 a 4096. Unidade: pixel.
Fps	String	Não	Taxa de quadros. Por padrão, utiliza-se a taxa de quadros do arquivo de entrada. O valor será 60 se a taxa de quadros do arquivo de entrada exceder 60. Valores válidos: (0,60]. Unidade: quadros por segundo.
Gop	String	Não	Tamanho do grupo de imagens (GOP). O tamanho do GOP pode ser o intervalo máximo entre keyframes ou o número máximo de quadros em um grupo. Ao especificar o intervalo máximo entre keyframes, a unidade (s) é obrigatória. Valor padrão: 10s. Ao especificar o número máximo de quadros, o valor não possui unidade. Valores válidos: 1 a 100000.
Preset	String	Não	Algoritmo de vídeo predefinido. Valores válidos: veryfast, fast, medium, slow e slower. Valor padrão: medium. Este parâmetro é válido apenas quando o codec de vídeo é H.264.
ScanMode	String	Não	Modo de varredura. Valores válidos: interlaced e progressive.
Bufsize	String	Não	Tamanho do buffer. Valores válidos: [1000,128000]. Valor padrão: 6000. Unidade: KB.
Maxrate	String	Não	Taxa de bits máxima de vídeo. Valores válidos: [10,50000]. Unidade: Kbit/s.
PixFmt	String	Não	Formato de pixel para codificação de cores de vídeo. Formatos padrão como yuv420p e yuvj420p são suportados. O formato de pixel padrão pode ser yuv420p ou o formato de cor original.
Remove	String	Não	Indica se o fluxo de vídeo deve ser excluído. O valor true exclui o fluxo de vídeo. O valor false mantém o fluxo de vídeo. Valor padrão: false.
Crop	String	Não	Método de recorte de vídeo. O valor border detecta e recorta automaticamente as bordas pretas. Um valor no formato largura:altura:esquerda:topo recorta a imagem do vídeo com base na configuração personalizada. Exemplo: 1280:800:0:140.
Pad	String	Não	Bordas pretas a serem adicionadas ao vídeo. Formato: largura:altura:esquerda:topo. Exemplo: 1280:800:0:140.
LongShortMode	String	Não	Indica se o recurso de rotação automática de tela está ativado. Quando ativado, a largura do vídeo de saída corresponde ao lado longo do vídeo de entrada (que é a altura no modo retrato). A altura do vídeo de saída corresponde ao lado curto do vídeo de entrada (que é a largura no modo retrato). O valor true ativa o recurso. O valor false desativa o recurso. Valor padrão: false.

A tabela a seguir descreve as combinações suportadas de formatos de container, codecs de vídeo e codecs de áudio.

Formato de container	Codec de áudio	Codec de vídeo
FLV	AAC e MP3	H.264
MP4	AAC e MP3	H.264 e H.265
TS	AAC e MP3	H.264 e H.265
M3U8	AAC e MP3	H.264 e H.265
GIF	Nenhum	GIF

A tabela a seguir descreve os parâmetros de fluxo de vídeo suportados por diferentes codecs de vídeo. O valor Y indica que o parâmetro é suportado. O valor N indica que o parâmetro não é suportado.

Parâmetro de fluxo de vídeo/Codec	H.264	H.265	GIF
Profile	Y	N	N
Bitrate	Y	Y	N
Crf	Y	Y	N
Width	Y	Y	Y
Height	Y	Y	Y
Fps	Y	Y	Y
Gop	Y	Y	N
Preset	Y	N	N
ScanMode	Y	Y	Y
Bufsize	Y	Y	N
Maxrate	Y	Y	N
PixFmt	Y	Y	Y (apenas BGR8)

Parâmetros aninhados sob o parâmetro Audio

Parâmetro	Tipo	Obrigatório	Descrição
Codec	String	Não	Codec de áudio. Codecs válidos: AAC, MP3, VORBIS e FLAC. Codec padrão: AAC.
Profile	String	Não	Perfil do codec de áudio. Valores válidos quando o codec de áudio é AAC: aac_low, aac_he, aac_he_v2, aac_ld e aac_eld.
Samplerate	String	Não	Taxa de amostragem. Valores válidos: 22050, 32000, 44100, 48000 e 96000. Valor padrão: 44100. Unidade: Hz. Se o formato do container de vídeo for FLV e o codec de áudio for MP3, a taxa de amostragem não pode ser 32000, 48000 ou 96000. Se o codec de áudio for MP3, a taxa de amostragem não pode ser 96000.
Bitrate	String	Não	Taxa de bits de áudio do arquivo de saída. Valores válidos: [8,1000]. Valor padrão: 128. Unidade: Kbit/s.
Channels	String	Não	Número de canais de som. Valor padrão: 2. Valores válidos quando o codec de áudio é MP3: 1 e 2. Valores válidos quando o codec de áudio é AAC: 1, 2, 4, 5, 6 e 8.
Remove	String	Não	Indica se o fluxo de áudio deve ser excluído. O valor true exclui o fluxo de áudio. O valor false mantém o fluxo de áudio. Valor padrão: false.

A tabela a seguir descreve as combinações suportadas de codecs de áudio e formatos de container.

Formato de container	Codec de áudio
MP3	MP3
MP4	AAC
OGG	VORBIS e FLAC
FLAC	FLAC

Parâmetros aninhados sob o parâmetro TransConfig

Parâmetro	Tipo	Obrigatório	Descrição
TransMode	String	Não	Modo de transcodificação. Valores válidos: onepass, twopass e CBR. Valor padrão: onepass.
AdjDarMethod	String	Não	Método de ajuste de resolução. Valores válidos: rescale, crop, pad e none. Valor padrão: none.
IsCheckReso	String	Não	Indica se a resolução deve ser verificada. Se este recurso estiver ativado e o sistema detectar que a resolução do arquivo de saída é superior à do arquivo de entrada (com base na largura ou altura), a resolução do arquivo de entrada será mantida após a transcodificação. O valor true ativa a verificação de resolução. O valor false desativa a verificação. Valor padrão: false.
IsCheckResoFail	String	Não	Indica se a resolução deve ser verificada. Se este recurso estiver ativado e o sistema detectar que a resolução do arquivo de saída é superior à do arquivo de entrada (com base na largura ou altura), um erro indicando falha na transcodificação será retornado. O valor true ativa a verificação de resolução. O valor false desativa a verificação. Valor padrão: false.
IsCheckVideoBitrate	String	Não	Indica se a taxa de bits de vídeo deve ser verificada. Se este recurso estiver ativado e o sistema detectar que a taxa de bits de vídeo do arquivo de saída é maior que a do arquivo de entrada, a taxa de bits de vídeo do arquivo de entrada será mantida após a transcodificação. O valor true ativa a verificação. O valor false desativa a verificação. Valor padrão: false.
IsCheckAudioBitrate	String	Não	Indica se a taxa de bits de áudio deve ser verificada. Se este recurso estiver ativado e o sistema detectar que a taxa de bits de áudio do arquivo de saída é maior que a do arquivo de entrada, a taxa de bits de áudio do arquivo de entrada será mantida após a transcodificação. O valor true ativa a verificação. O valor false desativa a verificação. Valor padrão: false.
IsCheckAudioBitrateFail	String	Não	Indica se a taxa de bits de áudio deve ser verificada. Se este recurso estiver ativado e o sistema detectar que a taxa de bits de áudio do arquivo de saída é maior que a do arquivo de entrada, o arquivo de entrada não será transcodificado. O valor true ativa a verificação. O valor false desativa a verificação. Valor padrão: false. Este parâmetro tem prioridade maior que o parâmetro IsCheckAudioBitrate.
IsCheckVideoBitrateFail	String	Não	Indica se a taxa de bits de vídeo deve ser verificada. Se este recurso estiver ativado e o sistema detectar que a taxa de bits de vídeo do arquivo de saída é maior que a do arquivo de entrada, o arquivo de entrada não será transcodificado. O valor true ativa a verificação. O valor false desativa a verificação. Valor padrão: false. Este parâmetro tem prioridade maior que o parâmetro IsCheckVideoBitrate.

Parâmetros aninhados sob o parâmetro MuxConfig

Parâmetro	Tipo	Obrigatório	Descrição
Segment	String	Não	Configuração de segmentação. O valor deve ser um objeto JSON. Para mais informações, consulte a seção a seguir.

Parâmetros aninhados sob o parâmetro Segment

Parâmetro	Tipo	Obrigatório	Descrição
Duration	String	Não	Duração do segmento. O valor deve ser um número inteiro. Unidade: segundos. Valores válidos: [1,60]. Valor padrão: 10.
ForceSegTime	String	Não	Especifica os pontos de tempo nos quais segmentar o arquivo de mídia. É possível especificar até 10 pontos de tempo. Separe os pontos de tempo com vírgulas (,). Os pontos de tempo podem ter precisão de três casas decimais. Unidade: segundos. Por exemplo, se você definir este parâmetro como 23,55,60, o arquivo de mídia será segmentado nos segundos 23, 55 e 60.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	FA258E67-09B8-4EAA-8F33-BA567834A2C3	ID da solicitação.
Template	Object		Detalhes do modelo de transcodificação.
Video	Object		Configuração do codec de vídeo.
Bufsize	String	6000	Tamanho do buffer. Valor padrão: 6000. Unidade: KB.
LongShortMode	String	false	Indica se o recurso de rotação automática de tela está ativado. Valor padrão: false. Valores válidos: true: O recurso de rotação automática de tela está ativado. false: O recurso de rotação automática de tela está desativado. Nota Se este recurso estiver ativado, a largura do vídeo de saída corresponde ao lado longo do vídeo de entrada (que é a altura no modo retrato). A altura do vídeo de saída corresponde ao lado curto do vídeo de entrada (que é a largura no modo retrato).
Degrain	String	10	Nível de controle de qualidade do vídeo.
BitrateBnd	Object		Intervalo de taxa de bits do vídeo.
Max	String	1500	Taxa de bits máxima.
Min	String	800	Taxa de bits mínima.
PixFmt	String	yuv420p	Formato de pixel para codificação de cores de vídeo. Formatos padrão como yuv420p e yuvj420p são suportados. O formato de pixel padrão pode ser yuv420p ou o formato de cor original.
Pad	String	1280:800:0:140	Bordas pretas a serem adicionadas ao vídeo. Formato: largura:altura:esquerda:topo.
Codec	String	H.264	Codec de vídeo. Codecs válidos: H.264, H.265, GIF e WebP. Codec padrão: H.264.
Height	String	800	Altura do vídeo. Unidade: pixel. Valor padrão: altura do vídeo de entrada.
Qscale	String	1	Nível do algoritmo independente de redução de ruído.
Crop	String	border	Método de recorte de vídeo. Valores válidos: border: detecta e remove bordas automaticamente. Valor no formato largura:altura:esquerda:topo: recorta a imagem do vídeo com base na configuração personalizada. Formato: largura:altura:esquerda:topo. Exemplo: 1280:800:0:140.
Bitrate	String	500	Taxa de bits do vídeo de saída. Unidade: Kbit/s.
Maxrate	String	500	Taxa de bits máxima de vídeo. Unidade: Kbit/s.
MaxFps	String	60	Taxa de quadros máxima.
Profile	String	high	Perfil do codec. Valores válidos: baseline: adequado para dispositivos móveis. main: adequado para dispositivos de definição padrão. high: adequado para dispositivos de alta definição. Valor padrão: high. Se houver múltiplas definições, recomenda-se definir este parâmetro como baseline para a menor definição, garantindo a reprodução normal em dispositivos básicos. Defina como main ou high para as demais definições. Nota Este parâmetro é válido apenas quando o codec de vídeo é H.264.
Crf	String	15	Fator de taxa constante. Valor padrão quando o codec de vídeo é H.264: 23. Valor padrão quando o codec de vídeo é H.265: 26. Nota Se este parâmetro for retornado, a configuração do parâmetro Bitrate será inválida.
Remove	String	false	Indica se o fluxo de vídeo deve ser excluído. true: O fluxo de vídeo é excluído. false: O fluxo de vídeo é mantido. Valor padrão: false.
Gop	String	10s	Tamanho do GOP. O tamanho do GOP pode ser o intervalo máximo entre keyframes ou o número máximo de quadros em um grupo. Se você especificou o intervalo máximo, o valor contém a unidade (s). Se você especificou o número máximo de quadros, o valor não contém unidade. Valor padrão: 10s.
Width	String	256	Largura do vídeo. Valor padrão: largura do vídeo de entrada. Unidade: pixel.
Fps	String	25	Taxa de quadros. Por padrão, utiliza-se a taxa de quadros do arquivo de entrada. O valor será 60 se a taxa de quadros do arquivo de entrada exceder 60. Unidade: quadros por segundo.
Preset	String	fast	Algoritmo de vídeo predefinido. Valor padrão: medium. Valores válidos: veryfast fast medium slow slower Nota Este parâmetro é válido apenas quando o codec de vídeo é H.264.
ScanMode	String	interlaced	Modo de varredura. Valores válidos: interlaced progressive
ResoPriority	String	0	Política de ajuste de resolução.
TransConfig	Object		Configuração geral de transcodificação.
IsCheckAudioBitrate	String	true	Indica se a taxa de bits de áudio deve ser verificada. Se este recurso estiver ativado e o sistema detectar que a taxa de bits de áudio do arquivo de saída é maior que a do arquivo de entrada, a taxa de bits de áudio do arquivo de entrada será mantida após a transcodificação. Nesse caso, a configuração do parâmetro Bitrate torna-se inválida. Este parâmetro tem prioridade menor que o parâmetro IsCheckAudioBitrateFail. true: A taxa de bits de áudio é verificada. false: A taxa de bits de áudio não é verificada. Valor padrão quando o parâmetro Bitrate não é especificado e o codec do arquivo de saída difere do codec do arquivo de entrada: false. Valor padrão quando o parâmetro Bitrate não é especificado e o codec do arquivo de saída é igual ao codec do arquivo de entrada: true.
TransMode	String	onepass	Modo de transcodificação. Valores válidos: onepass twopass CBR Valor padrão: onepass.
IsCheckReso	String	true	Indica se a resolução deve ser verificada. Se este recurso estiver ativado e o sistema detectar que a resolução do arquivo de saída é superior à do arquivo de entrada (com base na largura ou altura), a resolução do arquivo de entrada será mantida após a transcodificação. true: A resolução é verificada. false: A resolução não é verificada. Valor padrão: false.
IsCheckVideoBitrateFail	String	true	Indica se a taxa de bits de vídeo deve ser verificada. Se a taxa de bits de vídeo do arquivo de saída for maior que a do arquivo de entrada, este parâmetro tem prioridade maior que o parâmetro IsCheckVideoBitrate. Valores válidos: true: A taxa de bits de vídeo é verificada. Se a taxa de bits de vídeo do arquivo de saída for maior que a do arquivo de entrada, o arquivo de entrada não será transcodificado. false: A taxa de bits de vídeo não é verificada. Valor padrão: false.
AdjDarMethod	String	rescale	Método de ajuste de resolução. Valor padrão: none. Valores válidos: rescale: O vídeo de entrada é redimensionado. crop: O vídeo de entrada é recortado. none: Nenhuma alteração é feita.
IsCheckVideoBitrate	String	true	Indica se a taxa de bits de vídeo deve ser verificada. Se este recurso estiver ativado e o sistema detectar que a taxa de bits de vídeo do arquivo de saída é maior que a do arquivo de entrada, a taxa de bits de vídeo do arquivo de entrada será mantida após a transcodificação. true: A taxa de bits de vídeo é verificada. false: A taxa de bits de vídeo não é verificada. Valor padrão: false.
IsCheckResoFail	String	true	Indica se a resolução deve ser verificada. Se este recurso estiver ativado e o sistema detectar que a resolução do arquivo de saída é superior à do arquivo de entrada (com base na largura ou altura), um erro indicando falha na transcodificação será retornado. true: A resolução é verificada. false: A resolução não é verificada. Valor padrão: false.
IsCheckAudioBitrateFail	String	true	Indica se a taxa de bits de áudio deve ser verificada. Se a taxa de bits do áudio de saída for maior que a do áudio de entrada, este parâmetro tem prioridade maior que o parâmetro IsCheckAudioBitrate. true: A taxa de bits de áudio é verificada. Se a taxa de bits do áudio de saída for maior que a do áudio de entrada, o arquivo de entrada não será transcodificado. false: A taxa de bits de áudio não é verificada. Valor padrão: false.
State	String	Narmal	Status do modelo. Normal: O modelo está normal. Deleted: O modelo foi excluído.
MuxConfig	Object		Configuração de transmuxing.
Webp	Object		Configuração de transmuxing para WebP.
Loop	String	0	Contagem de loops.
Gif	Object		Configuração de transmuxing para GIF.
FinalDelay	String	0	Duração da pausa no quadro final. Unidade: centissegundos.
DitherMode	String	sierra	Algoritmo de dithering de cores da paleta. Valores válidos: sierra e bayer.
Loop	String	0	Contagem de loops.
IsCustomPalette	String	false	Indica se a paleta personalizada está em uso.
Segment	Object		Configuração de segmentação.
Duration	String	10	Duração do segmento. Unidade: segundos.
Name	String	mps-example	Nome do modelo.
Audio	Object		Configuração do codec de áudio.
Profile	String	aac_low	Perfil do codec de áudio. Valores válidos quando o codec de áudio é definido como AAC: aac_low aac_he aac_he_v2 aac_ld aac_eld
Remove	String	true	Indica se o fluxo de áudio deve ser excluído. true: O fluxo de áudio é excluído. false: O fluxo de áudio é mantido. Valor padrão: false.
Codec	String	aac	Formato do codec de áudio. Valor padrão: aac. Valores válidos: aac mp3 vorbis flac
Samplerate	String	44100	Taxa de amostragem. Unidade: Hz. Valor padrão: 44100.
Qscale	String	5	Nível do algoritmo independente de redução de ruído.
Channels	String	2	Número de canais de som. Valor padrão: 2.
Volume	Object		Detalhes do volume.
Method	String	auto	Método de ajuste de volume. Valores válidos: auto: O volume é ajustado automaticamente. dynamic: O volume é ajustado dinamicamente. linear: O volume é ajustado linearmente.
Level	String	-20	Faixa de ajuste de volume. Valor padrão: -20. Unidade: dB.
Bitrate	String	500	Taxa de bits de áudio do arquivo de saída. Unidade: Kbit/s. Valor padrão: 128.
Id	String	16f01ad6175e4230ac42bb5182cd****	ID do modelo de transcodificação. Recomendamos guardar este ID para chamadas de operações subsequentes.
Container	Object		Configuração do container.
Format	String	mp4	Formato do container.

Exemplos

Exemplos de solicitações

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=AddTemplate
&Name=mps-example
&Container={"Format":"mp4"}
&Video={"Codec":"H.264","Profile":"high","Bitrate":"500","Crf":"15","Width":"256","Height":"800","Fps":"25","Gop":"10s"}
&Audio={"Codec":"H.264","Samplerate":"44100","Bitrate":"500","Channels":"2"}
&TransConfig={"TransMode":"onepass"}
&MuxConfig={"Segment":{"Duration":"10"}}
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<AddTemplateResponse>
    <RequestId>FA258E67-09B8-4EAA-8F33-BA567834A2C3</RequestId>
    <Template>
        <Video>
            <Bufsize>6000</Bufsize>
            <LongShortMode>false</LongShortMode>
            <Degrain>10</Degrain>
            <BitrateBnd>
                <Max>1500</Max>
                <Min>800</Min>
            </BitrateBnd>
            <PixFmt>yuv420p</PixFmt>
            <Pad>1280:800:0:140</Pad>
            <Codec>H.264</Codec>
            <Height>800</Height>
            <Qscale>1</Qscale>
            <Crop>border</Crop>
            <Bitrate>500</Bitrate>
            <Maxrate>500</Maxrate>
            <MaxFps>60</MaxFps>
            <Profile>high</Profile>
            <Crf>15</Crf>
            <Remove>false</Remove>
            <Gop>10s</Gop>
            <Width>256</Width>
            <Fps>25</Fps>
            <Preset>fast</Preset>
            <ScanMode>interlaced</ScanMode>
            <ResoPriority>0</ResoPriority>
        </Video>
        <TransConfig>
            <IsCheckAudioBitrate>true</IsCheckAudioBitrate>
            <TransMode>onepass</TransMode>
            <IsCheckReso>true</IsCheckReso>
            <IsCheckVideoBitrateFail>true</IsCheckVideoBitrateFail>
            <AdjDarMethod>rescale</AdjDarMethod>
            <IsCheckVideoBitrate>true</IsCheckVideoBitrate>
            <IsCheckResoFail>true</IsCheckResoFail>
            <IsCheckAudioBitrateFail>true</IsCheckAudioBitrateFail>
        </TransConfig>
        <State>Narmal</State>
        <MuxConfig>
            <Webp>
                <Loop>0</Loop>
            </Webp>
            <Gif>
                <FinalDelay>0</FinalDelay>
                <DitherMode>sierra</DitherMode>
                <Loop>0</Loop>
                <IsCustomPalette>false</IsCustomPalette>
            </Gif>
            <Segment>
                <Duration>10</Duration>
            </Segment>
        </MuxConfig>
        <Name>mps-example</Name>
        <Audio>
            <Profile>aac_low</Profile>
            <Remove>true</Remove>
            <Codec>aac</Codec>
            <Samplerate>44100</Samplerate>
            <Qscale>5</Qscale>
            <Channels>2</Channels>
            <Volume>
                <Method>auto</Method>
                <Level>-20</Level>
            </Volume>
            <Bitrate>500</Bitrate>
        </Audio>
        <Id>16f01ad6175e4230ac42bb5182cd****</Id>
        <Container>
            <Format>mp4</Format>
        </Container>
    </Template>
</AddTemplateResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "FA258E67-09B8-4EAA-8F33-BA567834A2C3",
  "Template" : {
    "Video" : {
      "Bufsize" : "6000",
      "LongShortMode" : "false",
      "Degrain" : "10",
      "BitrateBnd" : {
        "Max" : "1500",
        "Min" : "800"
      },
      "PixFmt" : "yuv420p",
      "Pad" : "1280:800:0:140",
      "Codec" : "H.264",
      "Height" : "800",
      "Qscale" : "1",
      "Crop" : "border",
      "Bitrate" : "500",
      "Maxrate" : "500",
      "MaxFps" : "60",
      "Profile" : "high",
      "Crf" : "15",
      "Remove" : "false",
      "Gop" : "10s",
      "Width" : "256",
      "Fps" : "25",
      "Preset" : "fast",
      "ScanMode" : "interlaced",
      "ResoPriority" : "0"
    },
    "TransConfig" : {
      "IsCheckAudioBitrate" : "true",
      "TransMode" : "onepass",
      "IsCheckReso" : "true",
      "IsCheckVideoBitrateFail" : "true",
      "AdjDarMethod" : "rescale",
      "IsCheckVideoBitrate" : "true",
      "IsCheckResoFail" : "true",
      "IsCheckAudioBitrateFail" : "true"
    },
    "State" : "Narmal",
    "MuxConfig" : {
      "Webp" : {
        "Loop" : "0"
      },
      "Gif" : {
        "FinalDelay" : "0",
        "DitherMode" : "sierra",
        "Loop" : "0",
        "IsCustomPalette" : "false"
      },
      "Segment" : {
        "Duration" : "10"
      }
    },
    "Name" : "mps-example",
    "Audio" : {
      "Profile" : "aac_low",
      "Remove" : "true",
      "Codec" : "aac",
      "Samplerate" : "44100",
      "Qscale" : "5",
      "Channels" : "2",
      "Volume" : {
        "Method" : "auto",
        "Level" : "-20"
      },
      "Bitrate" : "500"
    },
    "Id" : "16f01ad6175e4230ac42bb5182cd****",
    "Container" : {
      "Format" : "mp4"
    }
  }
}

Códigos de erro

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.