Tous les produits
Search

Ce produit

    :AddTemplate

    Centre de documentation

    :AddTemplate

    Dernière mise à jour :Aug 10, 2026

    Crée un modèle de transcodage personnalisé qui couvre divers paramètres, tels que les paramètres du conteneur, de la vidéo et de l'audio.

    Notes d'utilisation

    Vous pouvez appeler cette opération pour définir les paramètres liés au conteneur, aux flux audio et aux flux vidéo. Pour certains paramètres, si vous ne les spécifiez pas, les flux générés à l'aide du modèle n'incluront pas les paramètres correspondants.

    Limites QPS

    Vous pouvez appeler cette opération jusqu'à 100 fois par seconde par compte. Les requêtes dépassant cette limite sont rejetées, ce qui entraîne des interruptions de service. Nous vous recommandons de prendre en compte cette limite lors de l'appel à cette opération. Pour plus d'informations, consultez la rubrique Limite QPS.

    Débogage

    OpenAPI Explorer calcule automatiquement la valeur de signature. Par souci de simplicité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

    Paramètres de requête

    Paramètre Type Obligatoire Exemple Description
    Action String Oui AddTemplate

    L'opération que vous souhaitez effectuer. Définissez la valeur sur AddTemplate.

    Name String Oui mps-example

    Le nom du modèle. Le nom peut comporter jusqu'à 128 octets.

    Container String Non {"Format":"mp4"}

    La configuration du conteneur. La valeur doit être un objet JSON et contenir le paramètre Format. Si vous ne configurez pas le conteneur, le fichier multimédia transcodé est au format MP4 par défaut. Si vous souhaitez utiliser le modèle de transcodage pour générer des fichiers multimédias dans d'autres formats, ce paramètre est obligatoire. Pour plus d'informations, consultez la section Paramètres imbriqués sous le paramètre Container de cette rubrique.

    • Valeur par défaut du paramètre Format : mp4.
    • Les formats vidéo incluent FLV, MP4, HLS (M3U8 + TS) et MPEG-DASH (MPD + fMP4).
    Remarque Si le format du conteneur est FLV, le codec vidéo ne peut pas être défini sur H.265.
    • Les formats audio incluent MP3, MP4, Ogg, FLAC et M4A.
    • Les formats d'image incluent GIF et WebP.
    Remarque Si le format du conteneur est GIF, le codec vidéo doit être GIF. Si le format du conteneur est WebP, le codec vidéo doit être défini sur WebP.
    Video String Non {"Codec":"H.264","Profile":"high","Bitrate":"500","Crf":"15","Width":"256","Height":"800","Fps":"25","Gop":"10s"}

    La configuration du flux vidéo. La valeur doit être un objet JSON. Pour plus d'informations, consultez la section Paramètres imbriqués sous le paramètre Video de cette rubrique.

    Remarque Si vous ne définissez pas ce paramètre, les fichiers de sortie ne contiendront pas de flux vidéo. Si vous devez conserver les flux vidéo, ce paramètre est obligatoire.
    Audio String Non {"Codec":"H.264","Samplerate":"44100","Bitrate":"500","Channels":"2"}

    La configuration du flux audio. La valeur doit être un objet JSON. Pour plus d'informations, consultez la section Paramètres imbriqués sous le paramètre Audio de cette rubrique.

    Remarque Si vous ne définissez pas ce paramètre, les fichiers de sortie ne contiendront pas de flux audio. Si vous devez conserver les flux audio, ce paramètre est obligatoire.
    TransConfig String Non {"TransMode":"onepass"}

    La configuration générale du transcodage. La valeur doit être un objet JSON. Pour plus d'informations, consultez la section Paramètres imbriqués sous le paramètre TransConfig de cette rubrique. Si vous ne définissez pas ce paramètre, les paramètres par défaut sont utilisés. Si les paramètres par défaut ne répondent pas à vos besoins de transcodage, configurez les paramètres imbriqués sous le paramètre TransConfig selon vos besoins.

    MuxConfig String Non {"Segment":{"Duration":"10"}}

    La configuration des segments. La valeur doit être un objet JSON. Pour plus d'informations, consultez la section Paramètres imbriqués sous le paramètre MuxConfig de cette rubrique. Si vous ne définissez pas ce paramètre, aucun fichier de segment multimédia n'est généré. Si vous souhaitez générer des fichiers de segment multimédia, ce paramètre est obligatoire.

    Paramètres imbriqués sous le paramètre Container

    Parameter

    Type

    Required

    Description

    Format

    String

    No

    Valeur par défaut : mp4. Les formats vidéo pris en charge sont FLV, MP4, HLS (M3U8 + TS) et MPEG-DASH (MPD + fMP4). Les formats audio incluent MP3, MP4, Ogg, FLAC et M4A. Les formats d'image sont GIF et WebP. Si vous définissez le format du conteneur sur GIF ou WebP, le codec vidéo doit être respectivement défini sur GIF ou WebP. Si le format du conteneur est défini sur FLV, le codec vidéo ne peut pas être H.265.
    Paramètres imbriqués sous le paramètre Video

    Parameter

    Type

    Required

    Description

    Codec

    String

    No

    Le codec vidéo. Codecs vidéo valides : H.264, H.265, GIF et WebP. Codec vidéo par défaut : H.264.

    Profile

    String

    No

    Le profil du codec. Valeurs valides : baseline, main et high. Valeur par défaut : high. La valeur baseline indique que les fichiers multimédias sont transcodés pour les appareils mobiles. La valeur main spécifie un transcodage pour les appareils à résolution standard. La valeur high cible les appareils à haute résolution. En cas de définitions multiples, il est recommandé de définir ce paramètre sur baseline pour la définition la plus basse afin de garantir une lecture normale sur les appareils d'entrée de gamme. Définissez ce paramètre sur main ou high pour les autres définitions. Ce paramètre n'est valide que si le codec vidéo est défini sur H.264.

    Bitrate

    String

    No

    Le débit binaire. Valeurs valides : 10 à 50000. Unité : Kbit/s.

    Crf

    String

    No

    Le facteur de débit constant (CRF). Valeurs valides : 0 à 51. Valeur par défaut : 26. Si ce paramètre est renvoyé, le réglage du paramètre Bitrate est ignoré.

    Width

    String

    No

    La largeur de la vidéo. Valeur par défaut : la largeur de la vidéo d'entrée. Valeurs valides : 128 à 4096. Unité : pixel.

    Height

    String

    No

    La hauteur de la vidéo. Valeur par défaut : la hauteur de la vidéo d'entrée. Valeurs valides : 128 à 4096. Unité : pixel.

    Fps

    String

    No

    La fréquence d'images. Par défaut, la fréquence d'images du fichier d'entrée est utilisée. La valeur est plafonnée à 60 si la fréquence du fichier d'entrée dépasse 60. Valeurs valides : (0,60]. Unité : images par seconde.

    Gop

    String

    No

    La taille du groupe d'images (GOP). Elle peut correspondre à l'intervalle maximal entre les images clés ou au nombre maximal d'images dans un groupe. Si vous spécifiez l'intervalle maximal des images clés, l'unité (s) est requise. Valeur par défaut : 10s. Si vous spécifiez le nombre maximal d'images, la valeur ne comporte pas d'unité. Valeurs valides : 1 à 100000.

    Preset

    String

    No

    L'algorithme vidéo prédéfini. Valeurs valides : veryfast, fast, medium, slow et slower. Valeur par défaut : medium. Ce paramètre n'est valide que si le codec vidéo est défini sur H.264.

    ScanMode

    String

    No

    Le mode de balayage. Valeurs valides : interlaced et progressive.

    Bufsize

    String

    No

    La taille du tampon. Valeurs valides : [1000,128000]. Valeur par défaut : 6000. Unité : KB.

    Maxrate

    String

    No

    Le débit binaire vidéo maximal. Valeurs valides : [10,50000]. Unité : Kbit/s.

    PixFmt

    String

    No

    Le format de pixel pour l'encodage des couleurs vidéo. Les formats de pixel standards tels que yuv420p et yuvj420p sont pris en charge. Le format de pixel par défaut peut être yuv420p ou le format de couleur d'origine.

    Remove

    String

    No

    Indique s'il faut supprimer le flux vidéo. La valeur true supprime le flux vidéo. La valeur false conserve le flux vidéo. Valeur par défaut : false.

    Crop

    String

    No

    La méthode de recadrage vidéo. La valeur border détecte et recadre automatiquement les bordures noires. Une valeur au format width:height:left:top permet de recadrer l'image vidéo selon des paramètres personnalisés. Exemple : 1280:800:0:140.

    Pad

    String

    No

    Les bordures noires à ajouter à la vidéo. Format : width:height:left:top. Exemple : 1280:800:0:140.

    LongShortMode

    String

    No

    Indique s'il faut activer la fonction de rotation automatique de l'écran. 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 (qui est la hauteur en mode portrait). La hauteur de la vidéo de sortie correspond au côté court de la vidéo d'entrée (qui est la largeur en mode portrait). La valeur true active la fonction. La valeur false la désactive. Valeur par défaut : false.

    Le tableau suivant décrit les combinaisons prises en charge entre les formats de conteneur, les codecs vidéo et les codecs audio.

    Container format

    Audio codec

    Video codec

    FLV

    AAC and MP3

    H.264

    MP4

    AAC and MP3

    H.264 and H.265

    TS

    AAC and MP3

    H.264 and H.265

    M3U8

    AAC and MP3

    H.264 and H.265

    GIF

    No

    GIF

    Le tableau suivant présente les paramètres de flux vidéo pris en charge par les différents codecs vidéo. La valeur Y indique que le paramètre est pris en charge. La valeur N indique qu'il ne l'est pas.

    Video stream parameter/Codec

    H.264

    H.265

    GIF

    Profile

    Y

    N

    N

    Bitrate

    Y

    Y

    N

    Crf

    Y

    Y

    N

    Width

    Y

    Y

    Y

    Height

    Y

    Y

    Y

    Fps

    Y

    Y

    Y

    Gop

    Y

    Y

    N

    Preset

    Y

    N

    N

    ScanMode

    Y

    Y

    Y

    Bufsize

    Y

    Y

    N

    Maxrate

    Y

    Y

    N

    PixFmt

    Y

    Y

    Y (only BGR8)
    Paramètres imbriqués sous le paramètre Audio

    Parameter

    Type

    Required

    Description

    Codec

    String

    No

    Le codec audio. Codecs audio valides : AAC, MP3, VORBIS et FLAC. Codec audio par défaut : AAC.

    Profile

    String

    No

    Le profil du codec audio. Valeurs valides lorsque le codec audio est défini sur AAC : aac_low, aac_he, aac_he_v2, aac_ld et aac_eld.

    Samplerate

    String

    No

    La fréquence d'échantillonnage. Valeurs valides : 22050, 32000, 44100, 48000 et 96000. Valeur par défaut : 44100. Unité : Hz. Si le format du conteneur vidéo est FLV et que le codec audio est MP3, la fréquence d'échantillonnage ne peut pas être 32000, 48000 ou 96000. Si le codec audio est MP3, la fréquence d'échantillonnage ne peut pas être 96000.

    Bitrate

    String

    No

    Le débit binaire audio du fichier de sortie. Valeurs valides : [8,1000]. Valeur par défaut : 128. Unité : Kbit/s.

    Channels

    String

    No

    Le nombre de canaux audio. Valeur par défaut : 2. Valeurs valides lorsque le codec audio est défini sur MP3 : 1 et 2. Valeurs valides lorsque le codec audio est défini sur AAC : 1, 2, 4, 5, 6 et 8.

    Remove

    String

    No

    Indique s'il faut supprimer le flux audio. La valeur true supprime le flux audio. La valeur false conserve le flux audio. Valeur par défaut : false.

    Le tableau suivant décrit les combinaisons prises en charge entre les codecs audio et les formats de conteneur.

    Container format

    Audio codec

    MP3

    MP3

    MP4

    AAC

    OGG

    VORBIS and FLAC

    FLAC

    FLAC
    Paramètres imbriqués sous le paramètre TransConfig

    Parameter

    Type

    Required

    Description

    TransMode

    String

    No

    Le mode de transcodage. Valeurs valides : onepass, twopass et CBR. Valeur par défaut : onepass.

    AdjDarMethod

    String

    No

    La méthode d'ajustement de la résolution. Valeurs valides : rescale, crop, pad et none. Valeur par défaut : none.

    IsCheckReso

    String

    No

    Indique s'il faut vérifier la résolution. Si cette fonction est activée et que le système détecte que la résolution du fichier de sortie est supérieure à celle du fichier d'entrée (selon la largeur ou la hauteur), la résolution du fichier d'entrée est conservée après le transcodage. La valeur true active la vérification. La valeur false la désactive. Valeur par défaut : false.

    IsCheckResoFail

    String

    No

    Indique s'il faut vérifier la résolution. Si cette fonction est activée et que le système détecte que la résolution du fichier de sortie est supérieure à celle du fichier d'entrée (selon la largeur ou la hauteur), une erreur indiquant un échec du transcodage est renvoyée. La valeur true active la vérification. La valeur false la désactive. Valeur par défaut : false.

    IsCheckVideoBitrate

    String

    No

    Indique s'il faut vérifier le débit binaire vidéo. Si cette fonction est activée 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. La valeur true active la vérification. La valeur false la désactive. Valeur par défaut : false.

    IsCheckAudioBitrate

    String

    No

    Indique s'il faut vérifier le débit binaire audio. Si cette fonction est activée et que le système détecte que le débit binaire audio du fichier de sortie est supérieur à celui du fichier d'entrée, le débit binaire audio du fichier d'entrée est conservé après le transcodage. La valeur true active la vérification. La valeur false la désactive. Valeur par défaut : false.

    IsCheckAudioBitrateFail

    String

    No

    Indique s'il faut vérifier le débit binaire audio. Si cette fonction est activée et que le système détecte que le débit binaire audio du fichier de sortie est supérieur à celui du fichier d'entrée, le fichier d'entrée n'est pas transcodé. La valeur true active la vérification. La valeur false la désactive. Valeur par défaut : false. Ce paramètre a une priorité plus élevée que le paramètre IsCheckAudioBitrate.

    IsCheckVideoBitrateFail

    String

    No

    Indique s'il faut vérifier le débit binaire vidéo. Si cette fonction est activée 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 fichier d'entrée n'est pas transcodé. La valeur true active la vérification. La valeur false la désactive. Valeur par défaut : false. Ce paramètre a une priorité plus élevée que le paramètre IsCheckVideoBitrate.
    Paramètres imbriqués sous le paramètre MuxConfig

    Parameter

    Type

    Required

    Description

    Segment

    String

    No

    La configuration des segments. La valeur doit être un objet JSON. Pour plus d'informations, consultez la section suivante.
    Paramètres imbriqués sous le paramètre Segment

    Parameter

    Type

    Required

    Description

    Duration

    String

    No

    La durée du segment. La valeur doit être un entier. Unité : secondes. Valeurs valides : [1,60]. Valeur par défaut : 10.

    ForceSegTime

    String

    No

    Spécifie les points temporels auxquels vous souhaitez segmenter le fichier multimédia. Vous pouvez spécifier jusqu'à 10 points temporels. Séparez les points par des virgules (,). Les points temporels peuvent être précisés jusqu'à trois décimales. Unité : secondes. Par exemple, si vous définissez ce paramètre sur 23,55,60, le fichier multimédia sera segmenté aux 23e, 55e et 60e secondes.

    Paramètres de réponse

    Parameter Type Example Description
    RequestId String FA258E67-09B8-4EAA-8F33-BA567834A2C3

    L'ID de la requête.
    Template Object

    Les détails du modèle de transcodage.
    Video Object

    La configuration du codec vidéo.
    Bufsize String 6000

    La taille du tampon.

    • Valeur par défaut : 6000.
    • Unité : Ko.
    LongShortMode String false

    Indique si la fonction de rotation automatique de l'écran est activée. Valeur par défaut : false. Valeurs valides :

    • true : La fonction de rotation automatique de l'écran est activée.
    • false : La fonction de rotation automatique de l'écran est désactivée.
    Remarque Si cette fonctionnalité est activée, la largeur de la vidéo de sortie correspond au côté long de la vidéo d'entrée (soit la hauteur de la vidéo d'entrée en mode portrait). La hauteur de la vidéo de sortie correspond au côté court de la vidéo d'entrée (soit la largeur de la vidéo d'entrée en mode portrait).
    Degrain String 10

    Le niveau de contrôle de qualité de la vidéo.
    BitrateBnd Object

    La plage de débit binaire de la vidéo.
    Max String 1500

    Le débit binaire maximal.
    Min String 800

    Le débit binaire minimal.
    PixFmt String yuv420p

    Le format de pixel pour le codage des couleurs vidéo. Les formats de pixel standard tels que yuv420p et yuvj420p sont pris en charge. Le format de pixel par défaut peut être yuv420p ou le format de couleur d'origine.
    Pad String 1280:800:0:140

    Les bordures noires à ajouter à la vidéo. Format : largeur:hauteur:gauche:haut.
    Codec String H.264

    Le codec vidéo. Codecs vidéo valides : H.264, H.265, GIF et WebP. Codec vidéo par défaut : H.264.
    Height String 800

    La hauteur de la vidéo.

    • Unité : pixel.
    • Valeur par défaut : la hauteur de la vidéo d'entrée.
    Qscale String 1

    Le niveau de l'algorithme de débruitage indépendant.
    Crop String border

    La méthode de recadrage vidéo. Valeurs valides :

    • border : détecte et supprime automatiquement les bordures.
    • Valeur au format width:height:left:top : recadre l'image vidéo selon le paramètre personnalisé. Format : largeur:hauteur:gauche:haut. Exemple : 1280:800:0:140.
    Bitrate String 500

    Le débit binaire de la vidéo de sortie. Unité : Kbit/s.
    Maxrate String 500

    Le débit binaire vidéo maximal. Unité : Kbit/s.
    MaxFps String 60

    La fréquence d'images maximale.
    Profile String high

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

    Si plusieurs définitions existent, il est recommandé de définir ce paramètre sur baseline pour la définition la plus basse afin de garantir une lecture normale sur les appareils d'entrée de gamme. Définissez ce paramètre sur main ou high pour les autres définitions.

    Remarque Ce paramètre n'est valide que lorsque le codec vidéo est défini sur H.264.
    Crf String 15

    Le facteur de débit constant. Valeur par défaut lorsque le codec vidéo est défini sur H.264 : 23. Valeur par défaut lorsque le codec vidéo est défini sur H.265 : 26.

    Remarque Si ce paramètre est renvoyé, le paramétrage du paramètre Bitrate n'est pas valide.
    Remove String false

    Indique si le flux vidéo doit être supprimé.

    • true : Le flux vidéo est supprimé.
    • false : Le flux vidéo est conservé.
    • Valeur par défaut : false.
    Gop String 10s

    La taille du GOP. La taille du GOP peut correspondre à l'intervalle maximal entre les images clés ou au nombre maximal d'images dans un groupe d'images. Si vous avez spécifié l'intervalle maximal, la valeur contient l'unité (s). Si vous avez spécifié le nombre maximal d'images, la valeur ne contient pas d'unité. Valeur par défaut : 10s.
    Width String 256

    La largeur de la vidéo.

    • Valeur par défaut : la largeur de la vidéo d'entrée.
    • Unité : pixel.
    Fps String 25

    La fréquence d'images. Par défaut, la fréquence d'images du fichier d'entrée est utilisée. La valeur est de 60 si la fréquence d'images du fichier d'entrée dépasse 60. Unité : images par seconde.
    Preset String fast

    L'algorithme vidéo prédéfini. Valeur par défaut : medium. Valeurs valides :

    • veryfast
    • fast
    • medium
    • slow
    • slower
    Remarque Ce paramètre n'est valide que lorsque le codec vidéo est défini sur H.264.
    ScanMode String interlaced

    Le mode de balayage. Valeurs valides :

    • interlaced
    • progressive
    ResoPriority String 0

    La politique d'ajustement de la résolution.
    TransConfig Object

    La configuration générale de transcodage.
    IsCheckAudioBitrate String true

    Indique si le débit binaire audio doit être vérifié. Si cette fonctionnalité est activée et que le système détecte que le débit binaire audio du fichier de sortie est supérieur à celui du fichier d'entrée, le débit binaire audio du fichier d'entrée est conservé après le transcodage. Dans ce cas, le paramétrage du paramètre Bitrate n'est pas valide. Ce paramètre a une priorité inférieure à celle du paramètre IsCheckAudioBitrateFail.

    • true : Le débit binaire audio est vérifié.
    • false : Le débit binaire audio n'est pas vérifié.
      • Valeur par défaut lorsque le paramètre Bitrate n'est pas spécifié et que le codec du fichier de sortie diffère de celui du fichier d'entrée : false.
      • Valeur par défaut lorsque le paramètre Bitrate n'est pas spécifié et que le codec du fichier de sortie est identique à celui du fichier d'entrée : true.
    TransMode String onepass

    Le mode de transcodage. Valeurs valides :

    • onepass
    • twopass
    • CBR
    • Valeur par défaut : onepass.
    IsCheckReso String true

    Indique si la résolution doit être vérifiée. Si cette fonctionnalité est activée et que le système détecte que la résolution du fichier de sortie est supérieure à celle du fichier d'entrée (sur la base de la largeur ou de la hauteur), la résolution du fichier d'entrée est conservée après le transcodage.

    • 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 true

    Indique si le débit binaire vidéo doit être vérifié. Si le débit binaire vidéo du fichier de sortie s'avère supérieur à celui du fichier d'entrée, ce paramètre a une priorité plus élevée que le paramètre IsCheckVideoBitrate. Valeurs valides :

    • true : Le débit binaire vidéo est vérifié. Si le débit binaire vidéo du fichier de sortie est supérieur à celui du fichier d'entrée, 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 rescale

    La 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 true

    Indique si le débit binaire vidéo doit être vérifié. Si cette fonctionnalité est activée 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.

    • 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 true

    Indique s'il faut vérifier la résolution. Si cette fonctionnalité est activée et que le système détecte que la résolution du fichier de sortie est supérieure à celle du fichier d'entrée (en largeur ou en hauteur), une erreur signalant l'échec du 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 true

    Indique s'il faut vérifier le débit binaire audio. Si le débit binaire de l'audio de sortie est supérieur à celui de l'audio d'entrée, ce paramètre a une priorité plus élevée que le paramètre IsCheckAudioBitrate.

    • true : 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 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 Narmal

    État du modèle.

    • Normal : Le modèle est normal.
    • Deleted : Le modèle est supprimé.
    MuxConfig Object

    Configuration du transmuxing.
    Webp Object

    Configuration du transmuxing pour WebP.
    Loop String 0

    Nombre de boucles.
    Gif Object

    Configuration du transmuxing pour 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 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 valides lorsque le codec audio est défini sur AAC :

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

    Indique s'il faut supprimer le flux audio.

    • true : Le flux audio est supprimé.
    • false : Le flux audio est conservé.
    • Valeur par défaut : false.
    Codec String aac

    Format du codec audio. Valeur par défaut : aac. Valeurs valides :

    • aac
    • mp3
    • vorbis
    • flac
    Samplerate String 44100

    Taux d'échantillonnage.

    • Unité : Hz.
    • Valeur par défaut : 44100.
    Qscale String 5

    Niveau de l'algorithme de débruitage indépendant.
    Channels String 2

    Nombre de canaux audio. Valeur par défaut : 2.
    Volume Object

    Détails du volume.
    Method String auto

    Méthode d'ajustement du volume. Valeurs valides :

    • auto : Ajustement automatique du volume.
    • dynamic : Ajustement dynamique du volume.
    • linear : Ajustement linéaire du volume.
    Level String -20

    Plage d'ajustement du volume.

    • Valeur par défaut : -20.
    • Unité : dB.
    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. Il est recommandé de conserver cet ID pour les appels d'opérations ultérieurs.
    Container Object

    Configuration du conteneur.
    Format String mp4

    Format du conteneur.

    Exemples

    Exemple de requête

    http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=AddTemplate
&Name=mps-example
&Container={"Format":"mp4"}
&Video={"Codec":"H.264","Profile":"high","Bitrate":"500","Crf":"15","Width":"256","Height":"800","Fps":"25","Gop":"10s"}
&Audio={"Codec":"H.264","Samplerate":"44100","Bitrate":"500","Channels":"2"}
&TransConfig={"TransMode":"onepass"}
&MuxConfig={"Segment":{"Duration":"10"}}
&<Common request parameters>

    Exemple de réponse en cas de succès

    Format XML

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

<AddTemplateResponse>
    <RequestId>FA258E67-09B8-4EAA-8F33-BA567834A2C3</RequestId>
    <Template>
        <Video>
            <Bufsize>6000</Bufsize>
            <LongShortMode>false</LongShortMode>
            <Degrain>10</Degrain>
            <BitrateBnd>
                <Max>1500</Max>
                <Min>800</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>500</Bitrate>
            <Maxrate>500</Maxrate>
            <MaxFps>60</MaxFps>
            <Profile>high</Profile>
            <Crf>15</Crf>
            <Remove>false</Remove>
            <Gop>10s</Gop>
            <Width>256</Width>
            <Fps>25</Fps>
            <Preset>fast</Preset>
            <ScanMode>interlaced</ScanMode>
            <ResoPriority>0</ResoPriority>
        </Video>
        <TransConfig>
            <IsCheckAudioBitrate>true</IsCheckAudioBitrate>
            <TransMode>onepass</TransMode>
            <IsCheckReso>true</IsCheckReso>
            <IsCheckVideoBitrateFail>true</IsCheckVideoBitrateFail>
            <AdjDarMethod>rescale</AdjDarMethod>
            <IsCheckVideoBitrate>true</IsCheckVideoBitrate>
            <IsCheckResoFail>true</IsCheckResoFail>
            <IsCheckAudioBitrateFail>true</IsCheckAudioBitrateFail>
        </TransConfig>
        <State>Narmal</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>true</Remove>
            <Codec>aac</Codec>
            <Samplerate>44100</Samplerate>
            <Qscale>5</Qscale>
            <Channels>2</Channels>
            <Volume>
                <Method>auto</Method>
                <Level>-20</Level>
            </Volume>
            <Bitrate>500</Bitrate>
        </Audio>
        <Id>16f01ad6175e4230ac42bb5182cd****</Id>
        <Container>
            <Format>mp4</Format>
        </Container>
    </Template>
</AddTemplateResponse>

    Format JSON

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

{
  "RequestId" : "FA258E67-09B8-4EAA-8F33-BA567834A2C3",
  "Template" : {
    "Video" : {
      "Bufsize" : "6000",
      "LongShortMode" : "false",
      "Degrain" : "10",
      "BitrateBnd" : {
        "Max" : "1500",
        "Min" : "800"
      },
      "PixFmt" : "yuv420p",
      "Pad" : "1280:800:0:140",
      "Codec" : "H.264",
      "Height" : "800",
      "Qscale" : "1",
      "Crop" : "border",
      "Bitrate" : "500",
      "Maxrate" : "500",
      "MaxFps" : "60",
      "Profile" : "high",
      "Crf" : "15",
      "Remove" : "false",
      "Gop" : "10s",
      "Width" : "256",
      "Fps" : "25",
      "Preset" : "fast",
      "ScanMode" : "interlaced",
      "ResoPriority" : "0"
    },
    "TransConfig" : {
      "IsCheckAudioBitrate" : "true",
      "TransMode" : "onepass",
      "IsCheckReso" : "true",
      "IsCheckVideoBitrateFail" : "true",
      "AdjDarMethod" : "rescale",
      "IsCheckVideoBitrate" : "true",
      "IsCheckResoFail" : "true",
      "IsCheckAudioBitrateFail" : "true"
    },
    "State" : "Narmal",
    "MuxConfig" : {
      "Webp" : {
        "Loop" : "0"
      },
      "Gif" : {
        "FinalDelay" : "0",
        "DitherMode" : "sierra",
        "Loop" : "0",
        "IsCustomPalette" : "false"
      },
      "Segment" : {
        "Duration" : "10"
      }
    },
    "Name" : "mps-example",
    "Audio" : {
      "Profile" : "aac_low",
      "Remove" : "true",
      "Codec" : "aac",
      "Samplerate" : "44100",
      "Qscale" : "5",
      "Channels" : "2",
      "Volume" : {
        "Method" : "auto",
        "Level" : "-20"
      },
      "Bitrate" : "500"
    },
    "Id" : "16f01ad6175e4230ac42bb5182cd****",
    "Container" : {
      "Format" : "mp4"
    }
  }
}

    Codes d'erreur

    Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur du service.