Todos os produtos
Search
Central de documentação

:SearchTemplate

Última atualização: Jun 27, 2026

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

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 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.

  • Máximo de 100 entradas por página.
  • Valor padrão: 10.
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.

  • All: consulta todos os modelos de transcodificação personalizados.
  • normal: consulta apenas modelos de transcodificação personalizados normais.
  • Deleted: consulta modelos de transcodificação personalizados excluídos.
  • Valor padrão: All.

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.

  • Unidade: KB.
  • Valor padrão: 6000.
LongShortMode String false

Indica se o recurso de rotação automática de tela está ativado.

  • Se ativado, a largura do vídeo de saída corresponde ao lado maior do vídeo de entrada (altura no modo retrato). A altura do vídeo de saída corresponde ao lado menor do vídeo de entrada (largura no modo retrato).
  • true: recurso de rotação automática de tela ativado.
  • false: recurso de rotação automática de tela desativado.
  • Valor padrão: false.
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.

  • Formato: largura:altura:esquerda:topo.
  • Exemplo: 1280:800:0:140.
Codec String H.264

Codec de vídeo.

  • Valores válidos: H.264 e H.265.
  • Valor 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

Intensidade do algoritmo independente de redução de ruído.

Crop String border

Método de corte do vídeo. Valores válidos:

  • border: detecta e remove bordas automaticamente.
  • Outros valores: modos de corte personalizados. Formato: largura:altura:esquerda:topo. Exemplo: 1280:800:0:140.
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:

  • 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

Fator de controle de qualidade da taxa de bits.

  • Valor padrão com Codec definido como H.264: 23. Valor padrão com Codec definido como H.265: 26.
  • Se este parâmetro for retornado, a configuração do parâmetro Bitrate torna-se inválida.
Remove String false

Indica se o fluxo de vídeo é excluído. Valores válidos:

  • true: fluxo de áudio excluído.
  • false: fluxo de áudio mantido.
  • Valor padrão: false.
Gop String 10

Número máximo de quadros entre dois keyframes. Valor padrão: 250.

Width String 256

Largura do vídeo.

  • Valores válidos: [128, 4096].
  • Unidade: pixel.
  • Valor padrão: largura original do vídeo.
Fps String 25

Taxa de quadros do vídeo.

  • O valor será 60 se a taxa de quadros do vídeo de entrada exceder 60.
  • Valor padrão: taxa de quadros do vídeo de entrada.
Preset String medium

Algoritmo de vídeo predefinido. Valor padrão: medium. Valores válidos:

  • veryfast
  • fast
  • medium
  • slow
  • slower
ScanMode String interlaced

Modo de varredura. Valores válidos:

  • interlaced: executa varredura entrelaçada.
  • progressive: executa varredura progressiva.
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:

  • true: verifica a taxa de bits de áudio.
  • false: não verifica a taxa de bits de áudio.
  • Valores padrão:
    • Se o parâmetro estiver 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 estiver 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

Modo de transcodificação. Valor padrão: onepass. Valores válidos:

  • onepass
  • twopass
  • CBR
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.

  • true: verifica a resolução.
  • false: não verifica a resolução.
  • 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 IsCheckVideoBitrate.

  • true: se a verificação da taxa de bits de vídeo falhar, o arquivo de entrada não será transcodificado.
  • false: não verifica a taxa de bits de vídeo.
  • Valor padrão: false.
AdjDarMethod String none

Método de ajuste de resolução. Valor padrão: none. Valores válidos:

  • rescale: redimensiona o vídeo de entrada.
  • crop: corta o vídeo de entrada.
  • none: nenhuma alteração.
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:

  • true: verifica a taxa de bits de vídeo.
  • false: não verifica a taxa de bits de vídeo.
  • Valor padrão: false.
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.

  • true: verifica a resolução.
  • false: não verifica a resolução.
  • 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 IsCheckAudioBitrate.

  • true: se a verificação da taxa de bits de áudio falhar, o arquivo de entrada não será transcodificado.
  • false: não verifica a taxa de bits de áudio.
  • Valor padrão: false.
State String Normal

Status do modelo. Valores válidos:

  • Normal: modelo normal.
  • Deleted: modelo excluído.
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:

  • aac_low
  • aac_he
  • aac_he_v2
  • aac_ld
  • aac_eld
Remove String false

Indica se o fluxo de áudio é excluído. Valores válidos:

  • true: fluxo de áudio excluído.
  • false: fluxo de áudio mantido.
  • Valor padrão: false.
Codec String aac

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 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.

  • Unidade: Kbit/s.
  • Valor padrão: 128.
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:

  • flv
  • mp4
  • ts
  • m3u8
  • gif
  • mp3
  • ogg
  • flac
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.