QueryTemplateList - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Cette opération permet d'interroger jusqu'à 10 modèles de transcodage personnalisés en une seule fois.

Limite de QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde. Si le nombre d'appels par seconde dépasse cette limite, un mécanisme de limitation du trafic (throttling) se déclenche et peut affecter votre activité. Tenez compte de cette limite lorsque vous appelez cette opération. Pour plus d'informations, consultez la section Limite de QPS.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. Il 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	QueryTemplateList	Opération à effectuer. Définissez la valeur sur QueryTemplateList.
TemplateIds	String	Oui	16f01ad6175e4230ac42bb5182cd,88c6ca184c0e424d5w5b665e2a12	ID des modèles de transcodage personnalisés à interroger. Vous pouvez interroger jusqu'à 10 modèles à la fois. Séparez les plusieurs ID par des virgules (,).

Paramètres de réponse

Paramètre	Type	Exemple	Description
NonExistTids	Array of String	88c6ca184c0e424d5w5b665e2a12****	ID des modèles introuvables. Ce paramètre n'est pas renvoyé si tous les modèles de transcodage spécifiés sont trouvés.
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 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). 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 rotation automatique de l'écran est activée. false : la rotation automatique de l'écran est désactivée. Valeur par défaut : false.
Degrain	String	10	Niveau de contrôle qualité de la vidéo.
BitrateBnd	Object		Plage de débit binaire moyen de la vidéo.
Max	String	100	Limite supérieure du débit binaire total. Unité : Kbit/s.
Min	String	500	Limite inférieure du débit binaire total. Unité : Kbit/s.
PixFmt	String	yuv420p	Format de pixel de la vidéo. Valeurs possibles : formats 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. 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 possibles : 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 possibles : 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 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 possibles : 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 de sortie. Unité : pixel. Valeur par défaut : largeur d'origine de la vidéo.
Fps	String	25	Fréquence d'images. 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. Valeurs possibles : veryfast, fast, medium, slow et slower. Valeur par défaut : medium.
ScanMode	String	interlaced	Mode de balayage. Codecs audio valides : interlaced : balayage entrelacé. progressive : balayage progressif.
ResoPriority	String	heightFirst	Politique d'ajustement de la résolution. Valeurs possibles : CropFirst, widthFirst et heightFirst.
TransConfig	Object		Configurations générales de transcodage.
IsCheckAudioBitrate	String	false	Indique si le débit binaire audio est vérifié. Si ce paramètre est défini sur true et que le système détecte que 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é est ignoré. Ce paramètre a une priorité inférieure à celle du paramètre IsCheckAudioBitrateFail. Valeurs possibles : true : le débit binaire vidéo est vérifié. false : la résolution n'est pas vérifiée. 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 possibles : 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), le système considère que la résolution de sortie est égale à la résolution d'entrée. true : le débit binaire vidéo est vérifié. 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 possibles : rescale : redimensionne la vidéo d'entrée. crop : recadre la vidéo d'entrée. none : aucun changement.
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 possibles : true : le débit binaire vidéo est vérifié. false : la résolution n'est pas vérifiée. Valeur par défaut : false.
IsCheckResoFail	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), le transcodage échoue. 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 audio é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 possibles : Normal : le modèle est actif. Deleted : le modèle est supprimé.
MuxConfig	Object		Configuration de remultiplexage.
Webp	Object		Configuration de remultiplexage pour WebP.
Loop	String	0	Nombre de boucles.
Gif	Object		Configuration de remultiplexage pour GIF.
FinalDelay	String	0	Durée de pause de la dernière image.
DitherMode	String	sierra	Algorithme de tramage des couleurs de la palette. Valeurs possibles : sierra et bayer.
Loop	String	0	Nombre de boucles.
IsCustomPalette	String	false	Indique si la 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 possibles 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 possibles : true : le flux audio est supprimé. false : le flux audio est conservé. Valeur par défaut : false.
Codec	String	aac	Codec audio. Codec audio par défaut : AAC. Valeurs possibles : 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.
Channels	String	2	Nombre de canaux audio. Valeur par défaut : 2.
Bitrate	String	500	Débit binaire audio du fichier de sortie. Valeurs possibles : [8, 1000]. Unité : Kbit/s. Valeur par défaut : 128.
Id	String	16f01ad6175e4230ac42bb5182cd****	ID du modèle de transcodage.
Container	Object		Configuration du conteneur.
Format	String	flv	Format du conteneur. Valeurs possibles : flv, mp4, ts, m3u8, gif, mp3, ogg et flac.
RequestId	String	BC860F04-778A-472F-AB39-E1BF329C1EA8	ID de la requête.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

XML format

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>

JSON format

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"
}

Codes d'erreur

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