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

Observações de uso

Não é possível atualizar um modelo de transcodificação personalizado se ele estiver em uso por um job já enviado.

Limite de QPS

Esta operação aceita até 100 chamadas por segundo. Se o número de chamadas por segundo exceder o limite, o throttling será acionado, o que pode afetar seus serviços. Recomendamos observar 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 requisição

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	UpdateTemplate	A operação a ser executada. Defina o valor como UpdateTemplate.
TemplateId	String	Sim	16f01ad6175e4230ac42bb5182cd****	O ID do modelo. Obtenha o ID do modelo na resposta da operação AddTemplate.
Name	String	Sim	MPS-example	O nome do modelo. O nome pode ter até 128 bytes.
Container	String	Não	{"Format":"mp4"}	O formato do contêiner. O valor é um objeto JSON. Formato padrão: MP4. Formatos de vídeo: FLV, MP4, HLS (M3U8 + TS) e MPEG-DASH (MPD + fMP4) Formatos de áudio: MP3, MP4, OGG, FLAC e M4A Formatos de imagem: GIF e WebP Para mais informações, consulte a seção "Container" do tópico Detalhes dos parâmetros.
Video	String	Não	{"Codec":"H.264","Profile":"high","Bitrate":"500","Crf":"15","Width":"256","Height":"800","Fps":"25","Gop":"10"}	A configuração do stream de vídeo. O valor é um objeto JSON. Para mais informações, consulte a seção "Video" do tópico Detalhes dos parâmetros.
Audio	String	Não	{"Codec":"aac","Samplerate":"44100","Bitrate":"500","Channels":"2"}	A configuração do stream de áudio. O valor é um objeto JSON. Para mais informações, consulte a seção "Audio" do tópico Detalhes dos parâmetros.
MuxConfig	String	Não	{"Segment":{"Duration":"10"}}	A configuração de transmuxing. O valor é um objeto JSON. Para mais informações, consulte a seção "MuxConfig" do tópico Detalhes dos parâmetros.
TransConfig	String	Não	{"TransMode":"onepass"}	A configuração geral de transcodificação. O valor é um objeto JSON. Para mais informações, consulte a seção "TransConfig" do tópico Detalhes dos parâmetros.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	5E4FB22E-B9EA-4E24-8FFC-B407EA71QW21	O ID da requisição.
Template	Object		O tipo do modelo de transcodificação.
Video	Object		As configurações do codec de vídeo.
LongShortMode	String	false	Indica se o recurso de rotação automática de tela está ativado. Se este recurso estiver ativado, a largura do vídeo de saída corresponde ao lado longo do vídeo de entrada (altura no modo retrato). A altura do vídeo de saída corresponde ao lado curto do vídeo de entrada (largura no modo retrato). true: O recurso de rotação automática de tela está ativado. false: O recurso de rotação automática de tela está desativado. Valor padrão: false.
Bufsize	String	6000	O tamanho do buffer. Unidade: KB. Valor padrão: 6000.
Degrain	String	10	O nível de controle de qualidade do vídeo.
BitrateBnd	Object		A faixa média de bitrate do vídeo.
Max	String	500	O limite superior do bitrate total. Unidade: Kbit/s.
Min	String	100	O limite inferior do bitrate total. Unidade: Kbit/s.
PixFmt	String	yuv420p	O formato de pixel. Valores válidos: formatos de pixel padrão, como yuv420p e yuvj420p.
Pad	String	1280:800:0:140	As bordas pretas a serem adicionadas ao vídeo. Formato: largura:altura:esquerda:topo. Exemplo: 1280:800:0:140.
Codec	String	H.264	O codec de vídeo. Valor padrão: H.264.
Height	String	800	A altura do vídeo de saída. Unidade: pixel. Valor padrão: a altura do vídeo de entrada.
Qscale	String	1	A intensidade do algoritmo independente de redução de ruído.
Crop	String	border	O método usado para recortar o vídeo. Valores válidos: border: detecta e remove bordas automaticamente. Outros valores: os modos de recorte personalizados. Formato: largura:altura:esquerda:topo. Exemplo: 1280:800:0:140.
Bitrate	String	200	O bitrate médio do vídeo. Unidade: Kbit/s.
Maxrate	String	500	O bitrate máximo do vídeo de saída. Unidade: Kbit/s.
MaxFps	String	60	A taxa de quadros máxima.
Profile	String	high	O perfil de codificação. 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.
Crf	String	15	O fator de controle de qualidade do bitrate. Valor padrão quando o parâmetro Codec é definido como H.264: 23. Valor padrão quando o parâmetro Codec é definido como H.265: 26. Se este parâmetro for especificado, a configuração do parâmetro Bitrate será ignorada.
Remove	String	false	Indica se o stream de vídeo é excluído. Valores válidos: true: O stream de vídeo é excluído. false: O stream de vídeo é mantido. Valor padrão: false.
Gop	String	10	O número máximo de quadros entre dois keyframes. Valor padrão: 250.
Width	String	256	A largura do vídeo. Unidade: pixel. Valor padrão: a largura original do vídeo.
Fps	String	25	A taxa de quadros. Um valor de 60 é retornado se a taxa de quadros do vídeo de entrada exceder 60. Valor padrão: a taxa de quadros do vídeo de entrada.
Preset	String	medium	O algoritmo de vídeo predefinido. Valor padrão: medium. Valores válidos: veryfast fast medium slow slower
ScanMode	String	interlaced	O modo de varredura. Valores válidos: interlaced: Executa varredura entrelaçada. progressive: Executa varredura progressiva.
ResoPriority	String	1	A política de ajuste de resolução.
TransConfig	Object		As configurações gerais de transcodificação.
IsCheckAudioBitrate	String	false	Indica se o bitrate de áudio é verificado. Se este parâmetro for definido como true e o sistema detectar que o bitrate do áudio de saída é maior que o do áudio de entrada, o bitrate do áudio de entrada será mantido após a transcodificação. Nesse caso, o bitrate de áudio especificado não terá efeito. Este parâmetro tem prioridade menor que o parâmetro IsCheckAudioBitrateFail. Valores válidos: true: O bitrate de áudio é verificado. false: O bitrate de áudio não é verificado. Valores padrão: Se o parâmetro for deixado em branco e o codec do áudio de saída for diferente do codec do áudio de entrada, o valor padrão é false. Se o parâmetro for deixado em branco e o codec do áudio de saída for igual ao codec do áudio de entrada, o valor padrão é true.
TransMode	String	onepass	O modo de transcodificação. Valor padrão: onepass. Valores válidos: onepass twopass CBR
IsCheckReso	String	false	Indica se a resolução é verificada. Se este parâmetro for definido como true e o sistema detectar que a resolução de saída é superior à resolução de entrada com base na largura ou altura, o sistema considerará que a resolução de saída é igual à resolução de entrada. true: A resolução é verificada. false: A resolução não é verificada. Valor padrão: false.
IsCheckVideoBitrateFail	String	false	Indica se o bitrate de vídeo é verificado. Este parâmetro tem precedência sobre o parâmetro IsCheckVideoBitrate. true: O bitrate de vídeo é verificado. false: O bitrate de vídeo não é verificado. Valor padrão: false.
AdjDarMethod	String	none	O método de ajuste de resolução. Valor padrão: none. Valores válidos: rescale: Redimensiona o vídeo de entrada. crop: Recorta o vídeo de entrada. none: Nenhuma alteração é feita.
IsCheckVideoBitrate	String	false	Indica se o bitrate de vídeo é verificado. Se este parâmetro for definido como true e o sistema detectar que o bitrate de vídeo do arquivo de saída é maior que o do arquivo de entrada, o bitrate de vídeo do arquivo de entrada será mantido após a transcodificação. Valores válidos: true: O bitrate de vídeo é verificado. false: O bitrate de vídeo não é verificado. Valor padrão: false.
IsCheckResoFail	String	false	Indica se a resolução é verificada. Se este parâmetro for definido como true e o sistema detectar que a resolução de saída é superior à resolução de entrada com base na largura ou altura, uma falha de transcodificação será retornada. true: A resolução é verificada. false: A resolução não é verificada. Valor padrão: false.
IsCheckAudioBitrateFail	String	false	Indica se o bitrate de áudio é verificado. Este parâmetro tem precedência sobre o parâmetro IsCheckAudioBitrate. true: O bitrate de áudio é verificado. false: O bitrate de áudio não é verificado. Valor padrão: false.
State	String	Normal	O status do modelo. Valores válidos: Normal: O modelo está normal. Deleted: O modelo foi excluído.
MuxConfig	Object		A configuração de transmuxing.
Webp	Object		A configuração de transmuxing para WebP.
Loop	String	0	A contagem de loops.
Gif	Object		A configuração de transmuxing para GIF.
FinalDelay	String	false	A duração da pausa do quadro final. Unidade: milissegundos.
DitherMode	String	bayer	O algoritmo de dithering de cores da paleta. Valores válidos: sierra e bayer.
Loop	String	0	A contagem de loops.
IsCustomPalette	String	0	Indica se a paleta personalizada é utilizada.
Segment	Object		A configuração do segmento.
Duration	String	10	A duração do segmento. Unidade: segundos.
Name	String	MPS-example	O nome do modelo.
Audio	Object		A configuração do codec de áudio.
Profile	String	aac_low	O perfil do codec de áudio. Valores válidos quando o parâmetro Codec é definido como aac: aac_low aac_he aac_he_v2 aac_ld aac_eld
Remove	String	false	Indica se o stream de áudio é excluído. Valores válidos: true: O stream de áudio é excluído. false: O stream de áudio é mantido. Valor padrão: false.
Codec	String	aac	O codec de áudio. Valor padrão: aac. Valores válidos: aac mp3 vorbis flac
Samplerate	String	44100	A taxa de amostragem. Unidade: Hz. Valor padrão: 44100.
Qscale	String	1	A intensidade do algoritmo independente de redução de ruído.
Channels	String	2	O número de canais de som. Valor padrão: 2.
Bitrate	String	500	O bitrate de áudio do arquivo de saída. Valores válidos: [8, 1000]. Unidade: Kbit/s. Valor padrão: 128.
Id	String	16f01ad6175e4230ac42bb5182cd****	O ID do modelo de transcodificação.
Container	Object		A configuração do contêiner.
Format	String	mp4	O formato do contêiner.

Exemplos

Exemplos de requisições

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

Exemplos de respostas de sucesso

Formato XML

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

<UpdateTemplateResponse>
    <RequestId>5E4FB22E-B9EA-4E24-8FFC-B407EA71QW21</RequestId>
    <Template>
        <Video>
            <LongShortMode>false</LongShortMode>
            <Bufsize>6000</Bufsize>
            <Degrain>10</Degrain>
            <BitrateBnd>
                <Max>500</Max>
                <Min>100</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>200</Bitrate>
            <Maxrate>500</Maxrate>
            <MaxFps>60</MaxFps>
            <Profile>high</Profile>
            <Crf>15</Crf>
            <Remove>false</Remove>
            <Gop>10</Gop>
            <Width>256</Width>
            <Fps>25</Fps>
            <Preset>medium</Preset>
            <ScanMode>interlaced</ScanMode>
            <ResoPriority>1</ResoPriority>
        </Video>
        <TransConfig>
            <IsCheckAudioBitrate>false</IsCheckAudioBitrate>
            <TransMode>onepass</TransMode>
            <IsCheckReso>false</IsCheckReso>
            <IsCheckVideoBitrateFail>false</IsCheckVideoBitrateFail>
            <AdjDarMethod>none</AdjDarMethod>
            <IsCheckVideoBitrate>false</IsCheckVideoBitrate>
            <IsCheckResoFail>false</IsCheckResoFail>
            <IsCheckAudioBitrateFail>false</IsCheckAudioBitrateFail>
        </TransConfig>
        <State>Normal</State>
        <MuxConfig>
            <Webp>
                <Loop>0</Loop>
            </Webp>
            <Gif>
                <FinalDelay>false</FinalDelay>
                <DitherMode>bayer</DitherMode>
                <Loop>0</Loop>
                <IsCustomPalette>0</IsCustomPalette>
            </Gif>
            <Segment>
                <Duration>10</Duration>
            </Segment>
        </MuxConfig>
        <Name>MPS-example</Name>
        <Audio>
            <Profile>aac_low</Profile>
            <Remove>false</Remove>
            <Codec>aac</Codec>
            <Samplerate>44100</Samplerate>
            <Qscale>1</Qscale>
            <Channels>2</Channels>
            <Bitrate>500</Bitrate>
        </Audio>
        <Id>16f01ad6175e4230ac42bb5182cd****</Id>
        <Container>
            <Format>mp4</Format>
        </Container>
    </Template>
</UpdateTemplateResponse>

Formato JSON

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

{
  "RequestId" : "5E4FB22E-B9EA-4E24-8FFC-B407EA71QW21",
  "Template" : {
    "Video" : {
      "LongShortMode" : "false",
      "Bufsize" : "6000",
      "Degrain" : "10",
      "BitrateBnd" : {
        "Max" : "500",
        "Min" : "100"
      },
      "PixFmt" : "yuv420p",
      "Pad" : "1280:800:0:140",
      "Codec" : "H.264",
      "Height" : "800",
      "Qscale" : "1",
      "Crop" : "border",
      "Bitrate" : "200",
      "Maxrate" : "500",
      "MaxFps" : "60",
      "Profile" : "high",
      "Crf" : "15",
      "Remove" : "false",
      "Gop" : "10",
      "Width" : "256",
      "Fps" : "25",
      "Preset" : "medium",
      "ScanMode" : "interlaced",
      "ResoPriority" : "1"
    },
    "TransConfig" : {
      "IsCheckAudioBitrate" : "false",
      "TransMode" : "onepass",
      "IsCheckReso" : "false",
      "IsCheckVideoBitrateFail" : "false",
      "AdjDarMethod" : "none",
      "IsCheckVideoBitrate" : "false",
      "IsCheckResoFail" : "false",
      "IsCheckAudioBitrateFail" : "false"
    },
    "State" : "Normal",
    "MuxConfig" : {
      "Webp" : {
        "Loop" : "0"
      },
      "Gif" : {
        "FinalDelay" : "false",
        "DitherMode" : "bayer",
        "Loop" : "0",
        "IsCustomPalette" : "0"
      },
      "Segment" : {
        "Duration" : "10"
      }
    },
    "Name" : "MPS-example",
    "Audio" : {
      "Profile" : "aac_low",
      "Remove" : "false",
      "Codec" : "aac",
      "Samplerate" : "44100",
      "Qscale" : "1",
      "Channels" : "2",
      "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.