Consulta modelos de transcodificação personalizados no estado especificado.
Notas de uso
Use esta operação para consultar modelos de transcodificação personalizados em um estado específico.
Limite de QPS
Você pode chamar esta operação até 100 vezes por segundo. Se a frequência de chamadas ultrapassar esse 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
Parâmetros da solicitação
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| Action | String | Sim | SearchTemplate | A operação a ser executada. Defina o valor como SearchTemplate. |
| PageSize | Long | Não | 10 | Número de entradas a retornar por página.
|
| PageNumber | Long | Não | 1 | Número da página a retornar. Valor padrão: 1. |
| State | String | Não | Normal | Status dos modelos de transcodificação personalizados a consultar.
|
Parâmetros de resposta
| Parâmetro | Tipo | Exemplo | Descrição |
| TotalCount | Long | 1 | Número total de entradas retornadas. |
| TemplateList | Array of Template | Detalhes dos modelos de transcodificação personalizados. |
|
| Template | |||
| Video | Object | Configuração do codec de vídeo. |
|
| Bufsize | String | 6000 | Tamanho do buffer.
|
| LongShortMode | String | false | Indica se o recurso de rotação automática de tela está ativado.
|
| Degrain | String | 10 | Nível de controle de qualidade do vídeo. |
| BitrateBnd | Object | Intervalo médio de taxa de bits do vídeo. |
|
| Max | String | 500 | Limite superior da taxa de bits total. Unidade: Kbit/s. |
| Min | String | 100 | Limite inferior da taxa de bits total. Unidade: Kbit/s. |
| PixFmt | String | yuv420p | Formato de pixel do vídeo. Valores válidos: formatos de pixel padrão, como yuv420p e yuvj420p. |
| Pad | String | 1280:800:0:140 | Bordas pretas a adicionar ao vídeo.
|
| Codec | String | H.264 | Codec de vídeo.
|
| Height | String | 800 | Altura do vídeo.
|
| Qscale | String | 1 | Intensidade do algoritmo independente de redução de ruído. |
| Crop | String | border | Método de corte do vídeo. Valores válidos:
|
| Bitrate | String | 200 | Taxa de bits média do vídeo. Unidade: Kbit/s. |
| Maxrate | String | 500 | Taxa de bits máxima do vídeo. Unidade: Kbit/s. |
| MaxFps | String | 60 | Taxa de quadros máxima. |
| Profile | String | high | Perfil do codec. Valores válidos:
|
| Crf | String | 15 | Fator de controle de qualidade da taxa de bits.
|
| Remove | String | false | Indica se o fluxo de vídeo é excluído. Valores válidos:
|
| Gop | String | 10 | Número máximo de quadros entre dois keyframes. Valor padrão: 250. |
| Width | String | 256 | Largura do vídeo.
|
| Fps | String | 25 | Taxa de quadros do vídeo.
|
| Preset | String | medium | Algoritmo de vídeo predefinido. Valor padrão: medium. Valores válidos:
|
| ScanMode | String | interlaced | Modo de varredura. Valores válidos:
|
| TransConfig | Object | Configurações gerais de transcodificação. |
|
| IsCheckAudioBitrate | String | false | Indica se 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 sistema mantém a taxa de bits do áudio de entrada 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 IsCheckAudioBitrateFail. Valores válidos:
|
| TransMode | String | onepass | Modo de transcodificação. Valor padrão: onepass. Valores válidos:
|
| IsCheckReso | String | false | Indica se a resolução é verificada. Se definido como true e o sistema detectar que a resolução de saída é maior que a de entrada (com base na largura ou altura), a resolução de saída será considerada igual à de entrada.
|
| 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 IsCheckVideoBitrate.
|
| AdjDarMethod | String | none | Método de ajuste de resolução. Valor padrão: none. Valores válidos:
|
| IsCheckVideoBitrate | String | false | Indica se a taxa de bits de vídeo é verificada. Se 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:
|
| IsCheckResoFail | String | false | Indica se a resolução é verificada. Se definido como true e o sistema detectar que a resolução de saída é maior que a de entrada (com base na largura ou altura), uma falha de transcodificação será retornada.
|
| 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 IsCheckAudioBitrate.
|
| State | String | Normal | Status do modelo. Valores válidos:
|
| MuxConfig | Object | Configurações de transmuxing. |
|
| 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 do segmento. |
|
| Duration | String | 10 | Comprimento 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 Codec é definido como aac:
|
| Remove | String | false | Indica se o fluxo de áudio é excluído. Valores válidos:
|
| Codec | String | aac | Codec de áudio. Valor padrão: aac. Valores válidos:
|
| Samplerate | String | 44100 | Taxa de amostragem.
|
| Qscale | String | 1 | Intensidade do algoritmo independente de redução de ruído. Valores válidos: [1, 9]. |
| Channels | String | 2 | Número de canais de som. Valor padrão: 2. |
| Bitrate | String | 500 | Taxa de bits de áudio do arquivo de saída.
|
| Id | String | 16f01ad6175e4230ac42bb5182cd**** | ID do modelo de transcodificação. |
| Container | Object | Configuração do contêiner. |
|
| Format | String | mp4 | Formato do contêiner. Valores válidos:
|
| PageSize | Long | 10 | Número de entradas retornadas por página. |
| RequestId | String | BC860F04-778A-472F-AB39-E1BF329C**** | ID da solicitação. |
| PageNumber | Long | 1 | Número da página retornada. |
Exemplos
Solicitações de exemplo
http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=SearchTemplate
&PageSize=10
&PageNumber=1
&State=Normal
&<Common request parameters>
Respostas de sucesso de exemplo
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<SearchTemplateResponse>
<TotalCount>1</TotalCount>
<TemplateList>
<Video>
<Bufsize>6000</Bufsize>
<LongShortMode>false</LongShortMode>
<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>
</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>
<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>mp4</Format>
</Container>
</TemplateList>
<PageSize>10</PageSize>
<RequestId>BC860F04-778A-472F-AB39-E1BF329C****</RequestId>
<PageNumber>1</PageNumber>
</SearchTemplateResponse>
Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"TotalCount" : 1,
"TemplateList" : [ {
"Video" : {
"Bufsize" : "6000",
"LongShortMode" : "false",
"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"
},
"TransConfig" : {
"IsCheckAudioBitrate" : "false",
"TransMode" : "onepass",
"IsCheckReso" : "false",
"IsCheckVideoBitrateFail" : "false",
"AdjDarMethod" : "none",
"IsCheckVideoBitrate" : "false",
"IsCheckResoFail" : "false",
"IsCheckAudioBitrateFail" : "false"
},
"State" : "Normal",
"MuxConfig" : {
"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" : "mp4"
}
} ],
"PageSize" : 10,
"RequestId" : "BC860F04-778A-472F-AB39-E1BF329C****",
"PageNumber" : 1
}
Códigos de erro
Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.