UpdateTemplate - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Il est impossible de mettre à jour un modèle de transcodage personnalisé s'il est utilisé par une tâche déjà soumise.

Limite QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde. Si le nombre d'appels par seconde dépasse la limite, un mécanisme de limitation (throttling) se déclenche, ce qui peut affecter votre activité. Tenez compte de cette limite lorsque vous appelez 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'appeler cette opération dans OpenAPI Explorer pour plus de commodité. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	UpdateTemplate	L'opération à effectuer. Définissez la valeur sur UpdateTemplate.
TemplateId	String	Yes	16f01ad6175e4230ac42bb5182cd****	L'ID du modèle. Vous pouvez obtenir l'ID du modèle à partir de la réponse de l'opération AddTemplate.
Name	String	Yes	MPS-example	Le nom du modèle. La longueur du nom ne doit pas dépasser 128 octets.
Container	String	No	{"Format":"mp4"}	Le format du conteneur. La valeur est un objet JSON. Format par défaut : MP4. Formats vidéo : FLV, MP4, HLS (M3U8 + TS) et MPEG-DASH (MPD + fMP4) Formats audio : MP3, MP4, OGG, FLAC et M4A Formats d'image : GIF et WebP Pour plus d'informations, consultez la section « Container » de la rubrique Détails des paramètres.
Video	String	No	{"Codec":"H.264","Profile":"high","Bitrate":"500","Crf":"15","Width":"256","Height":"800","Fps":"25","Gop":"10"}	La configuration du flux vidéo. La valeur est un objet JSON. Pour plus d'informations, consultez la section « Video » de la rubrique Détails des paramètres.
Audio	String	No	{"Codec":"aac","Samplerate":"44100","Bitrate":"500","Channels":"2"}	La configuration du flux audio. La valeur est un objet JSON. Pour plus d'informations, consultez la section « Audio » de la rubrique Détails des paramètres.
MuxConfig	String	No	{"Segment":{"Duration":"10"}}	La configuration de transmuxing. La valeur est un objet JSON. Pour plus d'informations, consultez la section « MuxConfig » de la rubrique Détails des paramètres.
TransConfig	String	No	{"TransMode":"onepass"}	La configuration générale de transcodage. La valeur est un objet JSON. Pour plus d'informations, consultez la section « TransConfig » de la rubrique Détails des paramètres.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	5E4FB22E-B9EA-4E24-8FFC-B407EA71QW21	L'ID de la requête.
Template	Object		Le type du modèle de transcodage.
Video	Object		Les configurations du codec vidéo.
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 (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). 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. Valeur par défaut : false.
Bufsize	String	6000	La taille du tampon. Unité : Ko. Valeur par défaut : 6000.
Degrain	String	10	Le niveau de contrôle qualité de la vidéo.
BitrateBnd	Object		La plage de débit binaire moyen de la vidéo.
Max	String	500	La limite supérieure du débit binaire total. Unité : Kbit/s.
Min	String	100	La limite inférieure du débit binaire total. Unité : Kbit/s.
PixFmt	String	yuv420p	Le format de pixel. Valeurs valides : formats de pixel standard tels que yuv420p et yuvj420p.
Pad	String	1280:800:0:140	Les bordures noires à ajouter à la vidéo. Format : width:height:left:top. Exemple : 1280:800:0:140.
Codec	String	H.264	Le codec vidéo. Valeur par défaut : H.264.
Height	String	800	La hauteur de la vidéo de sortie. Unité : pixel. Valeur par défaut : la hauteur de la vidéo d'entrée.
Qscale	String	1	La puissance de l'algorithme de réduction de bruit indépendant.
Crop	String	border	La méthode utilisée pour rogner la vidéo. Valeurs valides : border : détecte et supprime automatiquement les bordures. Autres valeurs : les modes de rognage personnalisés. Format : width:height:left:top. Exemple : 1280:800:0:140.
Bitrate	String	200	Le débit binaire moyen de la vidéo. Unité : Kbit/s.
Maxrate	String	500	Le débit binaire maximal de la vidéo de sortie. Unité : Kbit/s.
MaxFps	String	60	La fréquence d'images maximale.
Profile	String	high	Le profil d'encodage. Valeurs valides : baseline : applicable aux appareils mobiles. main : applicable aux appareils de définition standard. high : applicable aux appareils haute définition. Valeur par défaut : high.
Crf	String	15	Le 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 spécifié, le paramètre Bitrate est ignoré.
Remove	String	false	Indique si le flux vidéo est supprimé. Valeurs valides : true : le flux vidéo est supprimé. false : le flux vidéo est conservé. Valeur par défaut : false.
Gop	String	10	Le nombre maximal d'images entre deux images clés. Valeur par défaut : 250.
Width	String	256	La largeur de la vidéo. Unité : pixel. Valeur par défaut : la largeur vidéo d'origine.
Fps	String	25	La fréquence d'images. Une valeur de 60 est renvoyée si la fréquence d'images de la vidéo d'entrée dépasse 60. Valeur par défaut : la fréquence d'images de la vidéo d'entrée.
Preset	String	medium	L'algorithme vidéo prédéfini. Valeur par défaut : medium. Valeurs valides : veryfast fast medium slow slower
ScanMode	String	interlaced	Le mode de balayage. Valeurs valides : interlaced : un balayage entrelacé est effectué. progressive : un balayage progressif est effectué.
ResoPriority	String	1	La politique d'ajustement de la résolution.
TransConfig	Object		Les 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é ne prend pas effet. 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 laissé vide et que le codec de l'audio de sortie est différent de celui de l'audio d'entrée, la valeur par défaut est false. Si le paramètre est laissé 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	Le 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 en fonction de la largeur ou de la hauteur, le système considère que la résolution de sortie est é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 le débit binaire vidéo est vérifié. Ce paramètre est prioritaire par rapport au paramètre IsCheckVideoBitrate. 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.
AdjDarMethod	String	none	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 rognée. none : aucun changement n'est apporté.
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 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 en fonction de la largeur ou de la hauteur, un échec de transcodage est renvoyé. 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 le débit binaire audio est vérifié. Ce paramètre est prioritaire par rapport au paramètre IsCheckAudioBitrate. true : le débit binaire audio est vérifié. false : le débit binaire audio n'est pas vérifié. Valeur par défaut : false.
State	String	Normal	L'état du modèle. Valeurs valides : Normal : le modèle est normal. Deleted : le modèle est supprimé.
MuxConfig	Object		La configuration de transmuxing.
Webp	Object		La configuration de transmuxing pour WebP.
Loop	String	0	Le nombre de boucles.
Gif	Object		La configuration de transmuxing pour GIF.
FinalDelay	String	false	La durée pendant laquelle la dernière image est mise en pause. Unité : millisecondes.
DitherMode	String	bayer	L'algorithme de tramage des couleurs de la palette. Valeurs valides : sierra et bayer.
Loop	String	0	Le nombre de boucles.
IsCustomPalette	String	0	Indique si la palette personnalisée est utilisée.
Segment	Object		La configuration du segment.
Duration	String	10	La longueur du segment. Unité : secondes.
Name	String	MPS-example	Le nom du modèle.
Audio	Object		La configuration du codec audio.
Profile	String	aac_low	Le 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	Le codec audio. Valeur par défaut : aac. Valeurs valides : aac mp3 vorbis flac
Samplerate	String	44100	La fréquence d'échantillonnage. Unité : Hz. Valeur par défaut : 44100.
Qscale	String	1	La puissance de l'algorithme de réduction de bruit indépendant.
Channels	String	2	Le nombre de canaux audio. Valeur par défaut : 2.
Bitrate	String	500	Le débit binaire audio du fichier de sortie. Valeurs valides : [8, 1000]. Unité : Kbit/s. Valeur par défaut : 128.
Id	String	16f01ad6175e4230ac42bb5182cd****	L'ID du modèle de transcodage.
Container	Object		La configuration du conteneur.
Format	String	mp4	Le format du conteneur.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

XML format

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

<UpdateTemplateResponse>
    <RequestId>5E4FB22E-B9EA-4E24-8FFC-B407EA71QW21</RequestId>
    <Template>
        <Video>
            <LongShortMode>false</LongShortMode>
            <Bufsize>6000</Bufsize>
            <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>
            <ResoPriority>1</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>false</FinalDelay>
                <DitherMode>bayer</DitherMode>
                <Loop>0</Loop>
                <IsCustomPalette>0</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>
    </Template>
</UpdateTemplateResponse>

JSON format

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

{
  "RequestId" : "5E4FB22E-B9EA-4E24-8FFC-B407EA71QW21",
  "Template" : {
    "Video" : {
      "LongShortMode" : "false",
      "Bufsize" : "6000",
      "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",
      "ResoPriority" : "1"
    },
    "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" : "false",
        "DitherMode" : "bayer",
        "Loop" : "0",
        "IsCustomPalette" : "0"
      },
      "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"
    }
  }
}

Codes d'erreur

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