SearchTemplate - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Interrogez les modèles de transcodage personnalisés selon leur état.

Limite QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde. Si le nombre d'appels dépasse cette limite, un mécanisme de limitation du débit (throttling) est déclenché, ce qui peut affecter votre activité. Tenez compte de cette limite lors de l'utilisation de cette opération. Pour plus d'informations, consultez la rubrique Limite QPS.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. Celui-ci génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	SearchTemplate	Nom de l'opération à effectuer. Définissez la valeur sur SearchTemplate.
PageSize	Long	Non	10	Nombre d'entrées à renvoyer par page. Le nombre maximal d'entrées par page est de 100. Valeur par défaut : 10.
PageNumber	Long	Non	1	Numéro de la page à renvoyer. Valeur par défaut : 1.
State	String	Non	Normal	État des modèles de transcodage personnalisés à rechercher. All : recherche tous les modèles de transcodage personnalisés. normal : recherche les modèles de transcodage personnalisés actifs. Deleted : recherche les modèles de transcodage personnalisés supprimés. Valeur par défaut : All.

Paramètres de réponse

Paramètre	Type	Exemple	Description
TotalCount	Long	1	Nombre total d'entrées renvoyées.
TemplateList	Array of Template		Détails des modèles de transcodage personnalisés.
Template
Video	Object		Configuration du codec vidéo.
Bufsize	String	6000	Taille du tampon. Unité : Ko. Valeur par défaut : 6000.
LongShortMode	String	false	Indique si la fonction de rotation automatique de l'écran est activée. Si cette fonction est activée, la largeur de la vidéo de sortie correspond au côté long de la vidéo d'entrée (hauteur en mode portrait) et la hauteur de la vidéo de sortie correspond au côté court de la vidéo d'entrée (largeur en mode portrait). true : la fonction de rotation automatique est activée. false : la fonction de rotation automatique est désactivée. Valeur par défaut : false.
Degrain	String	10	Niveau de contrôle qualité appliqué à la vidéo.
BitrateBnd	Object		Plage du débit binaire moyen de la vidéo.
Max	String	500	Limite supérieure du débit binaire total. Unité : Kbit/s.
Min	String	100	Limite inférieure du débit binaire total. Unité : Kbit/s.
PixFmt	String	yuv420p	Format de pixel de la vidéo. Valeurs valides : formats de pixel standard tels que yuv420p et yuvj420p.
Pad	String	1280:800:0:140	Bandes noires à ajouter à la vidéo. Format : largeur:hauteur:gauche:haut. Exemple : 1280:800:0:140.
Codec	String	H.264	Codec vidéo. Valeurs valides : H.264 et H.265. Valeur par défaut : H.264.
Height	String	800	Hauteur de la vidéo. Unité : pixel. Valeur par défaut : hauteur de la vidéo d'entrée.
Qscale	String	1	Intensité de l'algorithme de réduction de bruit indépendant.
Crop	String	border	Méthode de recadrage vidéo. Valeurs valides : border : détecte et supprime automatiquement les bordures. Autres valeurs : modes de recadrage personnalisés. Format : largeur:hauteur:gauche:haut. Exemple : 1280:800:0:140.
Bitrate	String	200	Débit binaire moyen de la vidéo. Unité : Kbit/s.
Maxrate	String	500	Débit binaire maximal de la vidéo. Unité : Kbit/s.
MaxFps	String	60	Fréquence d'images maximale.
Profile	String	high	Profil du codec. Valeurs valides : baseline : adapté aux appareils mobiles. main : adapté aux appareils en définition standard. high : adapté aux appareils en haute définition. Valeur par défaut : high.
Crf	String	15	Facteur de contrôle de la qualité du débit binaire. Valeur par défaut lorsque le paramètre Codec est défini sur H.264 : 23. Valeur par défaut lorsque le paramètre Codec est défini sur H.265 : 26. Si ce paramètre est renvoyé, le paramètre Bitrate est ignoré.
Remove	String	false	Indique si le flux vidéo est supprimé. Valeurs valides : true : le flux audio est supprimé. false : le flux audio est conservé. Valeur par défaut : false.
Gop	String	10	Nombre maximal d'images entre deux images clés. Valeur par défaut : 250.
Width	String	256	Largeur de la vidéo. Valeurs valides : [128, 4096]. Unité : pixel. Valeur par défaut : largeur de la vidéo d'origine.
Fps	String	25	Fréquence d'images de la vidéo. La valeur est 60 si la fréquence d'images de la vidéo d'entrée dépasse 60. Valeur par défaut : fréquence d'images de la vidéo d'entrée.
Preset	String	medium	Algorithme vidéo prédéfini. Valeur par défaut : medium. Valeurs valides : veryfast fast medium slow slower
ScanMode	String	interlaced	Mode de balayage. Valeurs valides : interlaced : balayage entrelacé. progressive : balayage progressif.
TransConfig	Object		Configurations générales de transcodage.
IsCheckAudioBitrate	String	false	Indique si le débit binaire audio est vérifié. Si le débit binaire de l'audio de sortie est supérieur à celui de l'audio d'entrée, le débit binaire de l'audio d'entrée est conservé après le transcodage. Dans ce cas, le débit binaire audio spécifié n'est pas pris en compte. Ce paramètre a une priorité inférieure au paramètre IsCheckAudioBitrateFail. Valeurs valides : true : le débit binaire audio est vérifié. false : le débit binaire audio n'est pas vérifié. Valeurs par défaut : Si le paramètre est vide et que le codec de l'audio de sortie diffère de celui de l'audio d'entrée, la valeur par défaut est false. Si le paramètre est vide et que le codec de l'audio de sortie est identique à celui de l'audio d'entrée, la valeur par défaut est true.
TransMode	String	onepass	Mode de transcodage. Valeur par défaut : onepass. Valeurs valides : onepass twopass CBR
IsCheckReso	String	false	Indique si la résolution est vérifiée. Si ce paramètre est défini sur true et que le système détecte que la résolution de sortie est supérieure à la résolution d'entrée (selon la largeur ou la hauteur), la résolution de sortie est considérée comme égale à la résolution d'entrée. true : la résolution est vérifiée. false : la résolution n'est pas vérifiée. Valeur par défaut : false.
IsCheckVideoBitrateFail	String	false	Indique si les erreurs de vérification du débit binaire vidéo sont autorisées. Ce paramètre est prioritaire sur le paramètre IsCheckVideoBitrate. true : si la vérification du débit binaire vidéo échoue, le fichier d'entrée n'est pas transcodé. false : le débit binaire vidéo n'est pas vérifié. Valeur par défaut : false.
AdjDarMethod	String	none	Méthode d'ajustement de la résolution. Valeur par défaut : none. Valeurs valides : rescale : la vidéo d'entrée est redimensionnée. crop : la vidéo d'entrée est recadrée. none : aucun changement n'est effectué.
IsCheckVideoBitrate	String	false	Indique si le débit binaire vidéo est vérifié. Si ce paramètre est défini sur true et que le système détecte que le débit binaire vidéo du fichier de sortie est supérieur à celui du fichier d'entrée, le débit binaire vidéo du fichier d'entrée est conservé après le transcodage. Valeurs valides : true : le débit binaire vidéo est vérifié. false : le débit binaire vidéo n'est pas vérifié. Valeur par défaut : false.
IsCheckResoFail	String	false	Indique si la vérification de la résolution entraîne un échec. Si ce paramètre est défini sur true et que le système détecte que la résolution de sortie est supérieure à la résolution d'entrée (selon la largeur ou la hauteur), une erreur de transcodage est renvoyée. true : la résolution est vérifiée. false : la résolution n'est pas vérifiée. Valeur par défaut : false.
IsCheckAudioBitrateFail	String	false	Indique si les erreurs de vérification du débit binaire audio sont autorisées. Ce paramètre est prioritaire sur le paramètre IsCheckAudioBitrate. true : si la vérification du débit binaire vidéo échoue, le fichier d'entrée n'est pas transcodé. false : le débit binaire audio n'est pas vérifié. Valeur par défaut : false.
State	String	Normal	État du modèle. Valeurs valides : Normal : le modèle est actif. Deleted : le modèle est supprimé.
MuxConfig	Object		Configurations de transmuxing.
Gif	Object		Configuration de transmuxing pour le format GIF.
FinalDelay	String	0	Durée de pause sur la dernière image. Unité : centisecondes.
DitherMode	String	sierra	Algorithme de tramage des couleurs de la palette. Valeurs valides : sierra et bayer.
Loop	String	0	Nombre de boucles.
IsCustomPalette	String	false	Indique si une palette personnalisée est utilisée.
Segment	Object		Configuration des segments.
Duration	String	10	Durée du segment. Unité : secondes.
Name	String	MPS-example	Nom du modèle.
Audio	Object		Configuration du codec audio.
Profile	String	aac_low	Profil du codec audio. Valeurs valides lorsque le paramètre Codec est défini sur aac : aac_low aac_he aac_he_v2 aac_ld aac_eld
Remove	String	false	Indique si le flux audio est supprimé. Valeurs valides : true : le flux audio est supprimé. false : le flux audio est conservé. Valeur par défaut : false.
Codec	String	aac	Codec audio. Valeur par défaut : aac. Valeurs valides : aac mp3 vorbis flac
Samplerate	String	44100	Fréquence d'échantillonnage. Unité : Hz. Valeur par défaut : 44100.
Qscale	String	1	Intensité de l'algorithme de réduction de bruit indépendant. Valeurs valides : [1, 9].
Channels	String	2	Nombre de canaux audio. Valeur par défaut : 2.
Bitrate	String	500	Débit binaire audio du fichier de sortie. Unité : Kbit/s. Valeur par défaut : 128.
Id	String	16f01ad6175e4230ac42bb5182cd****	ID du modèle de transcodage.
Container	Object		Configuration du conteneur.
Format	String	mp4	Format du conteneur. Valeurs valides : flv mp4 ts m3u8 gif mp3 ogg flac
PageSize	Long	10	Nombre d'entrées renvoyées par page.
RequestId	String	BC860F04-778A-472F-AB39-E1BF329C****	ID de la requête.
PageNumber	Long	1	Numéro de la page renvoyée.

Exemples

Exemple de requête

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=SearchTemplate
&PageSize=10
&PageNumber=1
&State=Normal
&<Common request parameters>

Exemple de réponse réussie

XML format

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>

JSON format

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
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez la rubrique Codes d'erreur de service.