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

Observações de uso

Esta operação permite consultar até 10 modelos de transcodificação personalizados por vez.

Limite de QPS

O limite desta operação é de 100 chamadas por segundo. Se a quantidade de chamadas por segundo exceder esse valor, o sistema aciona o throttling, 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 solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	QueryTemplateList	A operação que você deseja executar. Defina o valor como QueryTemplateList.
TemplateIds	String	Sim	16f01ad6175e4230ac42bb5182cd,88c6ca184c0e424d5w5b665e2a12	Os IDs dos modelos de transcodificação personalizados que você deseja consultar. É possível consultar até 10 modelos de transcodificação personalizados por vez. Separe vários IDs de modelos de transcodificação personalizados com vírgulas (,).

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
NonExistTids	Array of String	88c6ca184c0e424d5w5b665e2a12****	Os IDs dos modelos que não existem. Este parâmetro não é retornado se todos os modelos de transcodificação especificados forem encontrados.
TemplateList	Array of Template		Os detalhes dos modelos de transcodificação personalizados.
Template
Video	Object		A configuração do codec de vídeo.
Bufsize	String	6000	O tamanho do buffer. Unidade: KB. Valor padrão: 6000.
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, que é a altura do vídeo de entrada no modo retrato. A altura do vídeo de saída corresponde ao lado curto do vídeo de entrada, que é a largura do vídeo de entrada 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.
Degrain	String	10	O nível de controle de qualidade do vídeo.
BitrateBnd	Object		A faixa média de taxa de bits do vídeo.
Max	String	100	O limite superior da taxa de bits total. Unidade: Kbit/s.
Min	String	500	O limite inferior da taxa de bits total. Unidade: Kbit/s.
PixFmt	String	yuv420p	O formato de pixel do vídeo. 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. 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 de corte do vídeo. Valores válidos: border: detecta e remove bordas automaticamente. Outros valores: os modos de corte personalizados. Formato: largura:altura:esquerda:topo. Exemplo: 1280:800:0:140.
Bitrate	String	200	A taxa de bits média do vídeo. Unidade: Kbit/s.
Maxrate	String	500	A taxa de bits máxima do vídeo. Unidade: Kbit/s.
MaxFps	String	60	A taxa de quadros máxima.
Profile	String	high	O perfil do codec. Valores válidos: baseline: aplicável a dispositivos móveis. main: aplicável a dispositivos de definição padrão. high: aplicável a dispositivos de alta definição. Valor padrão: high.
Crf	String	15	O fator de controle de qualidade da taxa de bits. Valor padrão quando o parâmetro Codec está definido como H.264: 23. Valor padrão quando o parâmetro Codec está definido como H.265: 26. 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 foi excluído. Valores válidos: true: O fluxo de áudio foi excluído. false: O fluxo de áudio foi mantido. Valor padrão: false.
Gop	String	10	O número máximo de quadros entre dois quadros-chave. Valor padrão: 250.
Width	String	256	A largura do vídeo de saída. Unidade: pixel. Valor padrão: a largura original do vídeo.
Fps	String	25	A taxa de quadros. O valor é 60 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. Valores válidos: veryfast, fast, medium, slow e slower. Valor padrão: medium.
ScanMode	String	interlaced	O modo de varredura. Codecs de áudio válidos: interlaced: Uma varredura entrelaçada é executada. progressive: Uma varredura progressiva é executada.
ResoPriority	String	heightFirst	A política de ajuste de resolução. Valores válidos: CropFirst, widthFirst e heightFirst.
TransConfig	Object		As configurações gerais de transcodificação.
IsCheckAudioBitrate	String	false	Indica se a taxa de bits de áudio é verificada. Se este parâmetro estiver definido como true e o sistema detectar que a taxa de bits do áudio de saída é maior que a taxa de bits do áudio de entrada, a taxa de bits do áudio de entrada será mantida após a transcodificação. Nesse caso, a taxa de bits de áudio especificada não entra em vigor. Este parâmetro tem prioridade menor que o parâmetro IsCheckAudioBitrateFail. Valores válidos: true: A taxa de bits de vídeo é verificada. false: A resolução não é verificada. Valores padrão: Se o parâmetro for deixado vazio 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 vazio 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 estiver definido como true e o sistema detectar que a resolução de saída é maior que a 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 taxa de bits de vídeo é verificada. false: A resolução não é verificada. Valor padrão: false.
IsCheckVideoBitrateFail	String	false	Indica se erros na verificação da taxa de bits de vídeo são permitidos. Este parâmetro tem precedência sobre o parâmetro IsCheckVideoBitrate. true: Se a verificação da taxa de bits de vídeo falhar, 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	none	O 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 é cortado. none: Nenhuma alteração é feita.
IsCheckVideoBitrate	String	false	Indica se a taxa de bits de vídeo é verificada. Se este parâmetro estiver definido como true 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. Valores válidos: true: A taxa de bits de vídeo é verificada. false: A resolução não é verificada. Valor padrão: false.
IsCheckResoFail	String	false	Indica se a resolução é verificada. Se este parâmetro estiver definido como true e o sistema detectar que a resolução de saída é maior que a 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 erros na verificação da taxa de bits de áudio são permitidos. Este parâmetro tem precedência sobre o parâmetro IsCheckAudioBitrate. true: Se a verificação da taxa de bits de áudio falhar, o arquivo de entrada não será transcodificado. false: A taxa de bits de áudio não é verificada. 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	0	A duração da pausa do quadro final.
DitherMode	String	sierra	O algoritmo de dithering de cores da paleta. Valores válidos: sierra e bayer.
Loop	String	0	A contagem de loops.
IsCustomPalette	String	false	Indica se a paleta personalizada é usada.
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 está definido como aac: aac_low aac_he aac_he_v2 aac_ld aac_eld
Remove	String	false	Indica se o fluxo de áudio foi excluído. Valores válidos: true: O fluxo de áudio foi excluído. false: O fluxo de áudio foi mantido. Valor padrão: false.
Codec	String	aac	O codec de áudio. Codec de áudio 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	A taxa de bits 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	flv	O formato do contêiner. Valores válidos: flv, mp4, ts, m3u8, gif, mp3, ogg e flac.
RequestId	String	BC860F04-778A-472F-AB39-E1BF329C1EA8	O ID da solicitação.

Exemplos

Solicitações de exemplo

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=QueryTemplateList
&TemplateIds=16f01ad6175e4230ac42bb5182cd****,88c6ca184c0e424d5w5b665e2a12****
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

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

<QueryTemplateListResponse>
    <NonExistTids>88c6ca184c0e424d5w5b665e2a12****</NonExistTids>
    <TemplateList>
        <Video>
            <Bufsize>6000</Bufsize>
            <LongShortMode>false</LongShortMode>
            <Degrain>10</Degrain>
            <BitrateBnd>
                <Max>100</Max>
                <Min>500</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>heightFirst</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>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>false</Remove>
            <Codec>aac</Codec>
            <Samplerate>44100</Samplerate>
            <Qscale>1</Qscale>
            <Channels>2</Channels>
            <Bitrate>500</Bitrate>
        </Audio>
        <Id>16f01ad6175e4230ac42bb5182cd****</Id>
        <Container>
            <Format>flv</Format>
        </Container>
    </TemplateList>
    <RequestId>BC860F04-778A-472F-AB39-E1BF329C1EA8</RequestId>
</QueryTemplateListResponse>

Formato JSON

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

{
  "NonExistTids" : [ "88c6ca184c0e424d5w5b665e2a12****" ],
  "TemplateList" : [ {
    "Video" : {
      "Bufsize" : "6000",
      "LongShortMode" : "false",
      "Degrain" : "10",
      "BitrateBnd" : {
        "Max" : "100",
        "Min" : "500"
      },
      "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" : "heightFirst"
    },
    "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" : "0",
        "DitherMode" : "sierra",
        "Loop" : "0",
        "IsCustomPalette" : "false"
      },
      "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" : "flv"
    }
  } ],
  "RequestId" : "BC860F04-778A-472F-AB39-E1BF329C1EA8"
}

Códigos de erro

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