Tous les produits
Search
Centre de documentation

ApsaraVideo Media Processing:AddTemplate

Dernière mise à jour :Aug 07, 2026

Crée un modèle de transcodage personnalisé. Vous devez configurer des informations telles que le format de conteneur, les paramètres de flux vidéo et les paramètres de flux audio.

Description de l'opération

Lors de l'appel de cette opération, vous devez définir les paramètres de transcodage, tels que ceux relatifs au format de conteneur, au flux vidéo et au flux audio. Si vous ne spécifiez pas certains paramètres, les flux générés à l'aide du modèle ne contiennent pas les informations spécifiées par ces paramètres.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

  • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

  • API : l'API que vous pouvez appeler pour exécuter l'action.

  • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

  • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

    • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

    • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

  • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

  • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

mts:AddTemplate

create

*All Resource

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

Name

string

Oui

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

mps-example

Container

string

Non

Le format du conteneur. La valeur doit être un objet JSON contenant le paramètre Format. Si vous ne spécifiez pas ce paramètre, le fichier multimédia transcodé est au format MP4 par défaut. Ce paramètre est requis si vous souhaitez utiliser le modèle de transcodage pour générer des fichiers multimédias dans d'autres formats. Pour plus d'informations, consultez Container.

  • Valeur par défaut : MP4.

  • Le transcodage vidéo prend en charge les formats suivants : 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.

  • Le transcodage audio prend en charge les formats suivants : MP3, MP4, OGG, FLAC et M4A.

  • Le transcodage d'images prend en charge les formats GIF et WebP.

Remarque
  • Si le format du conteneur est GIF, le codec vidéo doit être défini sur GIF.

  • Si le format du conteneur est WebP, le codec vidéo doit être défini sur WebP.

{"Format":"mp4"}

Video

string

Non

Les paramètres du flux vidéo. La valeur doit être un objet JSON. Pour plus d'informations, consultez Vidéo.

Remarque

Si vous ne spécifiez pas ce paramètre, les fichiers de sortie ne contiennent pas de flux vidéo. Ce paramètre est requis si vous souhaitez conserver les flux vidéo.

{"Codec":"H.264","Profile":"high","Bitrate":"500","Crf":"15","Width":"256","Height":"800","Fps":"25","Gop":"10s"}

Audio

string

Non

Les paramètres du flux audio. La valeur doit être un objet JSON. Pour plus d'informations, consultez Audio.

Remarque

Si vous ne spécifiez pas ce paramètre, les fichiers de sortie ne contiennent pas de flux audio. Ce paramètre est requis si vous souhaitez conserver les flux audio.

{"Codec":"H.264","Samplerate":"44100","Bitrate":"500","Channels":"2"}

TransConfig

string

Non

Les paramètres généraux de transcodage. La valeur doit être un objet JSON. Pour plus d'informations, consultez TransConfig. Si vous ne spécifiez pas ce paramètre, les paramètres par défaut sont utilisés. Ce paramètre est requis si les paramètres par défaut ne répondent pas à vos exigences métier.

{"TransMode":"onepass"}

MuxConfig

string

Non

Les paramètres de segment. La valeur doit être un objet JSON. Pour plus d'informations, consultez MuxConfig. Si vous ne spécifiez pas ce paramètre, les fichiers de segments multimédias ne sont pas générés. Ce paramètre est requis si vous souhaitez générer des fichiers de segments multimédias.

{"Segment":{"Duration":"10"}}

Conteneur

ParamètreTypeObligatoireDescription
FormatStringNonLa valeur par défaut de ce paramètre est MP4. Le transcodage vidéo prend en charge les formats suivants : FLV, MP4, HLS (M3U8 + TS) et MPEG-DASH (MPD + fMP4). Le transcodage audio prend en charge les formats suivants : MP3, MP4, OGG, FLAC et M4A. Le transcodage d'images prend en charge les formats GIF et WebP. Si vous définissez le format du conteneur sur GIF, le codec vidéo doit être défini sur GIF. Si vous définissez le format du conteneur sur WebP, le codec vidéo doit être défini sur WebP. Si vous définissez le format du conteneur sur FLV, le codec vidéo ne peut pas être défini sur H.265.

Vidéo

ParamètreTypeObligatoireDescription
CodecStringNonLe codec vidéo. Valeurs valides : H.264, H.265, GIF et WebP. Valeur par défaut : H.264.
ProfileStringNonLe 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 indique que les fichiers multimédias sont transcodés pour les appareils à résolution standard. La valeur high indique que les fichiers multimédias sont transcodés pour les appareils à haute résolution. Si plusieurs définitions sont disponibles, nous vous recommandons 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 paramètre Codec est défini sur H.264.
BitrateStringNonValeurs valides : 10 à 50000. Unité : Kbit/s.
CrfStringNonLe facteur de débit constant. Valeurs valides : 0 à 51. Valeur par défaut : 26. Si vous spécifiez ce paramètre, la configuration du paramètre Bitrate devient non valide.
WidthStringNonLa largeur de la vidéo. Valeurs valides : 128 à 4096. Valeur par défaut : la largeur de la vidéo d'entrée. Unité : pixel.
HeightStringNonLa hauteur de la vidéo. Valeurs valides : 128 à 4096. Valeur par défaut : la hauteur de la vidéo d'entrée. Unité : pixel.
FpsStringNonLa fréquence d'images de la vidéo. Valeur par défaut : la fréquence d'images du fichier d'entrée. La valeur est de 60 si la fréquence d'images du fichier d'entrée dépasse 60. Valeurs valides : 0 à 60. Unité : images par seconde.
GopStringNonLa taille du groupe d'images (GOP). La taille du GOP peut être l'intervalle maximum entre les images clés ou le nombre maximum d'images dans un groupe d'images. Si vous spécifiez l'intervalle maximum entre les images clés, l'unité (s) est requise. Valeur par défaut : 10s. Si vous spécifiez le nombre maximum d'images, la valeur n'a pas d'unité. Valeurs valides : 1 à 100000.
PresetStringNonL'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 paramètre Codec est défini sur H.264.
ScanModeStringNonLe mode de balayage. Valeurs valides : interlaced et progressive.
BufsizeStringNonLa taille de la mémoire tampon. Valeurs valides : 1000 à 128000. Valeur par défaut : 6000. Unité : Ko.
MaxrateStringNonLe débit binaire maximal de la vidéo. Valeurs valides : 10 à 50000. Unité : Kbit/s.
PixFmtStringNonLe format de pixel de la vidéo. Les formats de pixel standard tels que yuv420p et yuvj420p sont pris en charge. Par défaut, le format yuv420p ou le format de pixel de la vidéo d'entrée est utilisé.
RemoveStringNonIndique s'il faut supprimer le flux vidéo. La valeur true indique de supprimer le flux vidéo. La valeur false indique de conserver le flux vidéo. Valeur par défaut : false.
CropStringNonLa méthode de recadrage de la vidéo. La valeur border indique de détecter et de recadrer automatiquement les bandes noires. Une valeur au format width:height:left:top indique de recadrer l'image vidéo en fonction des paramètres personnalisés. Exemple : 1280:800:0:140.
PadStringNonLes bandes noires à ajouter à la vidéo. La valeur doit être au format width:height:left:top. Exemple : 1280:800:0:140.
LongShortModeStringNonIndique 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, c'est-à-dire 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, c'est-à-dire la largeur de la vidéo d'entrée en mode portrait. La valeur true indique d'activer la fonction de rotation automatique de l'écran. La valeur false indique de désactiver la fonction de rotation automatique de l'écran. Valeur par défaut : false.

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

Format de conteneurCodec audioCodec vidéo
FLVAAC et MP3H.264
MP4AAC et MP3H.264 et H.265
TSAAC et MP3H.264 et H.265
M3U8AAC et MP3H.264 et H.265
GIFNon pris en chargeGIF

Le tableau suivant décrit les paramètres de flux vidéo pris en charge par les différents codecs vidéo. Une valeur Y indique qu'un paramètre est pris en charge. Une valeur N indique qu'un paramètre n'est pas pris en charge.

Codec vidéoH.264H.265GIF
ProfilONN
Débit binaireOON
CRFOON
LargeurOOO
HauteurOOO
FPSOOO
GOPOON
PréréglageONN
Mode de balayageOOO
Taille de la mémoire tamponOON
Débit maximalOON
Format de pixelOObgr8

Audio

ParamètreTypeObligatoireDescription
CodecStringNonLe codec audio. Valeurs valides : AAC, MP3, VORBIS et FLAC. Valeur par défaut : AAC.
ProfileStringNonLe profil de codec audio. Valeurs valides si le paramètre Codec est défini sur AAC : aac_low, aac_he, aac_he_v2, aac_ld et aac_eld.
SamplerateStringNonLa fréquence d'échantillonnage. Valeurs valides : 22050, 32000, 44100, 48000 et 96000. Valeur par défaut : 44100. Unité : Hz. Si le format de 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.
BitrateStringNonLe débit binaire audio du fichier de sortie. Valeurs valides : 8 à 1000. Valeur par défaut : 128. Unité : Kbit/s.
ChannelsStringNonLe nombre de canaux audio. Valeur par défaut : 2. Valeurs valides si le paramètre Codec est défini sur MP3 : 1 et 2. Valeurs valides si le paramètre Codec est défini sur AAC : 1, 2, 4, 5, 6 et 8.
RemoveStringNonIndique si le flux audio doit être supprimé. La valeur true indique de supprimer le flux audio. La valeur false indique de conserver le flux audio. Valeur par défaut : false.

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

Format de conteneurCodec audio
MP3MP3
MP4AAC
OGGVORBIS et FLAC
FLACFLAC

TransConfig

ParamètreTypeObligatoireDescription
TransModeStringNoLe mode de transcodage. Valeurs valides : onepass, twopass et CBR. Valeur par défaut : onepass.
AdjDarMethodStringNoLa méthode d'ajustement de la résolution. Valeurs valides : rescale, crop, pad et none. Valeur par défaut : none.
IsCheckResoStringNoIndique 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 fonction de la largeur ou de la hauteur, la résolution du fichier d'entrée est conservée après le transcodage. La valeur true indique de vérifier la résolution. La valeur false indique de ne pas vérifier la résolution. Valeur par défaut : false.
IsCheckResoFailStringNoIndique 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 fonction de la largeur ou de la hauteur, une erreur indiquant un échec du transcodage est renvoyée. La valeur true indique de vérifier la résolution. La valeur false indique de ne pas vérifier la résolution. Valeur par défaut : false.
IsCheckVideoBitrateStringNoIndique s'il faut vérifier le débit binaire vidéo. 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. La valeur true indique de vérifier le débit binaire vidéo. La valeur false indique de ne pas vérifier le débit binaire vidéo. Valeur par défaut : false.
IsCheckAudioBitrateStringNoIndique s'il faut vérifier le débit binaire audio. 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. La valeur true indique de vérifier le débit binaire audio. La valeur false indique de ne pas vérifier le débit binaire audio. Valeur par défaut : false.
IsCheckAudioBitrateFailStringNoIndique s'il faut vérifier le débit binaire audio. Si cette fonctionnalité est activée 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, l'audio d'entrée n'est pas transcodé. La valeur true indique de vérifier le débit binaire audio. La valeur false indique de ne pas vérifier le débit binaire audio. Valeur par défaut : false. Ce paramètre est prioritaire sur le paramètre IsCheckAudioBitrate.
IsCheckVideoBitrateFailStringNoIndique s'il faut vérifier le débit binaire vidéo. Si cette fonctionnalité est activée et que le système détecte que le débit binaire de la vidéo de sortie est supérieur à celui de la vidéo d'entrée, la vidéo d'entrée n'est pas transcodée. La valeur true indique de vérifier le débit binaire vidéo. La valeur false indique de ne pas vérifier le débit binaire vidéo. Valeur par défaut : false. Ce paramètre est prioritaire sur le paramètre IsCheckVideoBitrate.

MuxConfig

ParamètreTypeObligatoireDescription
SegmentStringNonLes paramètres de segment. La valeur doit être un objet JSON. Pour plus d'informations, consultez la section suivante.

Segment

ParamètreTypeObligatoireDescription
DurationStringNonLa durée du segment. La valeur doit être un nombre entier. Unité : secondes. Valeurs valides : 1 à 60. Valeur par défaut : 10.
ForceSegTimeStringNonLes instants auxquels vous souhaitez segmenter le fichier multimédia. Vous pouvez spécifier jusqu'à 10 instants. Séparez les instants par des virgules (,). Les instants 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é à la 23e, 55e et 60e seconde.

Éléments de réponse

Élément

Type

Description

Exemple

object

Les paramètres de réponse.

RequestId

string

L'identifiant de la requête.

FA258E67-09B8-4EAA-8F33-BA567834A2C3

Template

object

Les détails du modèle de transcodage.

Video

object

Les configurations du codec vidéo.

Bufsize

string

The size of the buffer.

  • Default value: 6000.

  • Unit: KB.

6000

LongShortMode

string

Indicates whether the auto-rotate screen feature is enabled. Default value: false. Valid values:

  • true: The auto-rotate screen feature is enabled.

  • false: The auto-rotate screen feature is disabled.

Remarque

If this feature is enabled, the width of the output video corresponds to the long side of the input video, which is the height of the input video in portrait mode. The height of the output video corresponds to the short side of the input video, which is the width of the input video in portrait mode.

false

Degrain

string

The level of quality control on the video.

10

BitrateBnd

object

The bitrate range of the video.

Max

string

The maximum bitrate.

1500

Min

string

The minimum bitrate.

800

PixFmt

string

The pixel format. Standard pixel formats such as yuv420p and yuvj420p are supported. The default pixel format can be yuv420p or the pixel format of the input video.

yuv420p

Pad

string

The black borders to be added to the video. The value is in the width:height:left:top format.

1280:800:0:140

Codec

string

The video codec. Valid values: H.264, H.265, GIF, and WebP. Default value: H.264.

H.264

Height

string

The height of the video.

  • Unit: pixel.

  • Default value: the height of the input video.

800

Qscale

string

The level of the independent denoising algorithm.

1

Crop

string

The method of video cropping. Valid values:

  • border: automatically detects and removes borders.

  • Value in the format of width:height:left:top: crops the video image based on the custom settings. Example: 1280:800:0:140.

border

Bitrate

string

The bitrate of the output video. Unit: Kbit/s.

500

Maxrate

string

The maximum bitrate of the video. Unit: Kbit/s.

500

MaxFps

string

The maximum frame rate.

60

Profile

string

The codec profile.

  • baseline: suitable for mobile devices

  • main: suitable for standard-definition devices

  • high: suitable for high-definition devices

  • Default value: high.

If multiple definitions are available, we recommend that you set this parameter to baseline for the lowest definition to ensure normal playback on low-end devices. Set this parameter to main or high for other definitions.

Remarque

This parameter is valid only if the Codec parameter is set to H.264.

high

Crf

string

The constant rate factor. Default value if the video codec is set to H.264: 23. Default value if the video codec is set to H.265: 26.

Remarque

If this parameter is specified, the setting of the Bitrate parameter becomes invalid.

15

Remove

string

Indicates whether the video stream is deleted.

  • true: The video stream is deleted.

  • false: The video stream is retained.

  • Default value: false.

false

Gop

string

The GOP size. The GOP size can be the maximum interval of keyframes or the maximum number of frames in a frame group. If the maximum interval is specified, the value contains the unit (s). If the maximum number of frames is specified, the value does not contain a unit. Default value: 10s.

10s

Width

string

The width of the video.

  • Default value: the width of the input video.****

  • Unit: pixel.

256

Fps

string

The frame rate. Default value: the frame rate of the input file. The value is 60 if the frame rate of the input file exceeds 60. Unit: frames per second.

25

Preset

string

The preset video algorithm. Default value: medium. Valid values:

  • veryfast

  • fast

  • medium

  • slow

  • slower

Remarque

This parameter is valid only if the Codec parameter is set to H.264.

fast

ScanMode

string

The scan mode. Valid values:

  • interlaced

  • progressive

interlaced

ResoPriority

string

The policy of resolution adjustment.

0

Hdr2sdr

string

Indicates whether the HDR2SDR conversion feature is enabled. If this feature is enabled, high dynamic range (HDR) videos are transcoded to standard dynamic range (SDR) videos.

true

NarrowBand

object

The Narrowband HD settings.

Version

string

The Narrowband HD version. Only 1.0 may be returned.

1.0

Abrmax

number

The upper limit of the dynamic bitrate. If this parameter is set, the average bitrate is in the range of (0, 1000000].

3000

MaxAbrRatio

number

The maximum ratio of the upper limit of dynamic bitrate. If this parameter is set, the value of Abrmax does not exceed x times of the source video bitrate. Valid values: (0,1.0].

1.0

TransConfig

object

Les paramètres généraux de transcodage.

IsCheckAudioBitrate

string

Indicates whether the audio bitrate is checked.

If this feature is enabled and the system detects that the audio bitrate of the output file is greater than that of the input file, the audio bitrate of the input file is retained after transcoding.

  • true: The audio bitrate is checked.

  • false: The audio bitrate is not checked.

  • Default value: false.

true

TransMode

string

The transcoding mode. Valid values:

  • onepass

  • twopass

  • CBR

  • Default value: onepass.

onepass

IsCheckReso

string

Indicates whether the resolution is checked.

  • true: The resolution is checked.

  • false: The resolution is not checked.

  • Default value: false.

Remarque

If this feature is enabled and the system detects that the resolution of the output file is higher than that of the input file based on the width or height, the resolution of the input file is retained after transcoding.

true

IsCheckVideoBitrateFail

string

Indicates whether the video bitrate is checked. If this feature is enabled and the system detects that the video bitrate of the output file is higher than that of the input file, the input file is not transcoded. This parameter has a higher priority than the IsCheckVideoBitrate parameter.

  • true: The video bitrate is checked. In this case, if the video bitrate of the output file is higher than that of the input file, the input file is not transcoded.

  • false: The video bitrate is not checked.

  • Default value: false.

true

AdjDarMethod

string

The method of resolution adjustment. Default value: none. Valid values:

  • rescale: The input video is rescaled.

  • crop: The input video is cropped.

  • none: No change is made.

rescale

IsCheckVideoBitrate

string

Indicates whether the video bitrate is checked.

  • true: The video bitrate is checked.

  • false: The video bitrate is not checked.

  • Default value: false.

Remarque

If this feature is enabled and the system detects that the video bitrate of the output file is greater than that of the input file, the video bitrate of the input file is retained after transcoding.

true

IsCheckResoFail

string

Indicates whether the resolution is checked.

  • true: The resolution is checked.

  • false: The resolution is not checked.

  • Default value: false.

Remarque

If this feature is enabled and the system detects that the resolution of the output file is higher than that of the input file based on the width or height, an error that indicates a transcoding failure is returned.

true

IsCheckAudioBitrateFail

string

Indicates whether the audio bitrate is checked. If this feature is enabled and the system detects that the audio bitrate of the output file is higher than that of the input file, the input file is not transcoded. This parameter has a higher priority than the IsCheckAudioBitrate parameter. Valid values:

  • true: The audio bitrate is checked. In this case, if the audio bitrate of the output file is higher than that of the input file, the input file is not transcoded.

  • false: The audio bitrate is not checked.

  • Default value: false.

true

State

string

L'état du modèle. Valeurs valides :

  • Normal : Le modèle est normal.

  • Deleted : Le modèle est supprimé.

Normal

MuxConfig

object

Les paramètres de transmuxage.

Webp

object

The transmuxing settings for WebP.

Loop

string

The loop count.

0

Gif

object

The transmuxing settings for GIF.

FinalDelay

string

The duration for which the final frame is paused. Unit: centiseconds.

0

DitherMode

string

The color dithering algorithm of the palette. Valid values: sierra and bayer.

sierra

Loop

string

The loop count.

0

IsCustomPalette

string

Indicates whether the custom palette is used.

false

Segment

object

The segment settings.

Duration

string

The length of the segment. Unit: seconds.

10

Name

string

Le nom du modèle de transcodage.

mps-example

Audio

object

Les configurations du codec audio.

Profile

string

The codec profile of the audio. Valid values if the Codec parameter is set to AAC:

  • aac_low

  • aac_he

  • aac_he_v2

  • aac_ld

  • aac_eld

aac_low

Remove

string

Indicates whether the audio stream is deleted.

  • true: The audio stream is deleted.

  • false: The audio stream is retained.

  • Default value: false.

true

Codec

string

The audio codec format. Default value: aac. Valid values:

  • aac

  • mp3

  • vorbis

  • flac

aac

Samplerate

string

The sampling rate.

  • Unit: Hz.

  • Default value: 44100.

44100

Qscale

string

The level of the independent denoising algorithm.

5

Channels

string

The number of sound channels. Default value: 2.

2

Volume

object

The volume control configurations

Method

string

The volume adjustment method. Valid values:

  • auto: The volume is automatically adjusted.

  • dynamic: The volume is dynamically adjusted.

  • linear: The volume is linearly adjusted.

auto

Level

string

The volume adjustment range.

  • Default value: -20.

  • Unit: dB.

-20

IntegratedLoudnessTarget

string

The output volume.

This parameter takes effect only when the value of Method is dynamic.

Unit: dB.

Valid values: [-70,-5].

Default value: -6.

-6

TruePeak

string

The peak volume.

This parameter takes effect only when the value of Method is dynamic.

Unit: dB.

Valid values: [-9,0].

Default value: -1.

0

LoudnessRangeTarget

string

The range of the volume relative to the output volume.

This parameter takes effect only when the value of Method is dynamic.

Unit: dB.

Valid values: [1,20].

Default value: 8.

8

PeakLevel

string

The volume adjustment coefficient.

This parameter takes effect only when the value of Method is adaptive.

Valid values: [0,1].

Default value: 0.9.

0.9

Bitrate

string

The audio bitrate of the output file.

  • Unit: Kbit/s.

  • Default value: 128.

500

Id

string

L'identifiant du modèle de transcodage. Nous vous recommandons de conserver cet identifiant pour les appels d'opérations ultérieurs.

16f01ad6175e4230ac42bb5182cd****

Container

object

Les paramètres de format de conteneur.

Format

string

The container format.

mp4

Exemples

JSON format

{
  "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",
      "Hdr2sdr": "true",
      "NarrowBand": {
        "Version": "1.0",
        "Abrmax": 3000,
        "MaxAbrRatio": 1
      }
    },
    "TransConfig": {
      "IsCheckAudioBitrate": "true",
      "TransMode": "onepass",
      "IsCheckReso": "true",
      "IsCheckVideoBitrateFail": "true",
      "AdjDarMethod": "rescale",
      "IsCheckVideoBitrate": "true",
      "IsCheckResoFail": "true",
      "IsCheckAudioBitrateFail": "true"
    },
    "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": "true",
      "Codec": "aac",
      "Samplerate": "44100",
      "Qscale": "5",
      "Channels": "2",
      "Volume": {
        "Method": "auto",
        "Level": "-20",
        "IntegratedLoudnessTarget": "-6",
        "TruePeak": "0",
        "LoudnessRangeTarget": "8",
        "PeakLevel": "0.9"
      },
      "Bitrate": "500"
    },
    "Id": "16f01ad6175e4230ac42bb5182cd****",
    "Container": {
      "Format": "mp4"
    }
  }
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.