AddTemplate - ApsaraVideo Media Processing - Centre de documentation Alibaba Cloud

Crée un modèle personnalisé qui inclut les informations de conteneur, les paramètres de flux vidéo et les paramètres de flux audio.

Description de l'opération

Les paramètres de requête de cette opération incluent les informations de conteneur, les paramètres de flux vidéo et les paramètres de flux audio. Si vous ne configurez pas une partie spécifique, les informations correspondantes ne sont pas incluses dans le flux de sortie transcodé à l'aide du modèle.

Limite de QPS

La limite de QPS pour un seul utilisateur est de 100 appels par seconde. Si cette limite est dépassée, les appels d'API sont limités, ce qui peut affecter votre activité. Effectuez les appels d'API à un rythme raisonnable. Pour plus d'informations, consultez Limites de QPS.

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

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Name	string	Oui	Le nom du modèle. La longueur maximale est de 128 octets.	mps-example
Container	string	Non	Le conteneur. La valeur est un objet JSON qui contient le paramètre Format, qui spécifie le format du conteneur. Si vous ne configurez pas le paramètre Container, le format de sortie par défaut est MP4. Pour utiliser d'autres formats, vous devez configurer ce paramètre. Pour plus d'informations, consultez Détails du conteneur. Valeur par défaut : MP4. Le transcodage vidéo prend en charge 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 MP3, MP4, OGG, FLAC et M4A. Les images prennent en charge GIF et WebP. Remarque Si le format du conteneur est GIF, le codec vidéo peut uniquement être défini sur GIF. Si le format du conteneur est WebP, le codec vidéo peut uniquement être défini sur WebP.	{"Format":"mp4"}
Video	string	Non	Les configurations de flux vidéo. La valeur est un objet JSON. Pour plus d'informations, consultez Détails de la vidéo. Remarque Si vous ne configurez pas le paramètre Video, la sortie transcodée n'inclut pas le flux vidéo. Pour conserver le flux vidéo, vous devez configurer ce paramètre.	{"Codec":"H.264","Profile":"high","Bitrate":"500","Crf":"15","Width":"256","Height":"800","Fps":"25","Gop":"10s"}
Audio	string	Non	Les configurations de flux audio. La valeur est un objet JSON. Pour plus d'informations, consultez Détails de l'audio. Remarque Si vous ne configurez pas le paramètre Audio, la sortie transcodée n'inclut pas le flux audio. Pour conserver le flux audio, vous devez configurer ce paramètre.	{"Codec":"H.264","Samplerate":"44100","Bitrate":"500","Channels":"2"}
TransConfig	string	Non	Les configurations générales de transcodage. La valeur est un objet JSON. Pour plus d'informations, consultez Détails de TransConfig. Si vous ne configurez pas le paramètre TransConfig, toutes les configurations de transcodage utilisent les valeurs par défaut. Si les valeurs par défaut ne répondent pas à vos exigences de transcodage, vous devez configurer ce paramètre selon vos besoins.	{"TransMode":"onepass"}
MuxConfig	string	Non	Les configurations de segment. La valeur est un objet JSON. Pour plus d'informations, consultez Détails de MuxConfig. Si vous ne configurez pas le paramètre MuxConfig, la sortie transcodée n'est pas segmentée. Pour segmenter la sortie, vous devez configurer ce paramètre.	{"Segment":{"Duration":"10"}}

Détails de l'objet JSON Container

Paramètre	Type	Obligatoire	Description
Format	String	Non	Valeur par défaut : mp4. Le transcodage vidéo prend en charge flv, mp4, HLS (m3u8+ts) et MPEG-DASH (MPD+fMP4). Le transcodage audio prend en charge mp3, mp4, ogg, flac et m4a. Les images prennent en charge gif et WEBP. Si le format du conteneur est gif, le paramètre Video Codec doit être défini sur GIF. Si le format du conteneur est webp, le paramètre Video Codec doit être défini sur WEBP. Si le format du conteneur est flv, le paramètre Video Codec ne peut pas être défini sur H.265.

Détails de l'objet JSON Video

Paramètre	Type	Obligatoire	Description
Codec	String	Non	Le format de codec. Valeurs valides : H.264, H.265, GIF et WEBP. Valeur par défaut : H.264.
Profile	String	Non	Le profil d'encodage. Valeurs valides : baseline (adapté aux appareils mobiles), main (adapté aux appareils à définition standard) et high (adapté aux appareils à haute résolution). Valeur par défaut : high. Bonnes pratiques : Si vous avez plusieurs résolutions, définissez la résolution la plus basse sur baseline pour garantir la lecture sur les appareils d'entrée de gamme. Définissez les autres résolutions sur main ou high. Ce paramètre est pris en charge uniquement par H.264.
Bitrate	String	Non	Valeurs valides : 10 à 50000. Unité : Kbps.
Crf	String	Non	Le facteur de débit constant (CRF) pour le contrôle du débit binaire et de la qualité. Valeurs valides : 0 à 51. Valeur par défaut : 26. Si Crf est défini, les paramètres de débit binaire deviennent invalides.
Width	String	Non	La largeur de la vidéo. Valeur par défaut : la largeur de la vidéo d'origine. Valeurs valides : 128 à 4096. Unité : pixels.
Height	String	Non	La hauteur de la vidéo. Valeur par défaut : la hauteur de la vidéo d'origine. Valeurs valides : 128 à 4096. Unité : pixels.
Fps	String	Non	La fréquence d'images. Valeur par défaut : la fréquence d'images du fichier d'entrée. Si la fréquence d'images du fichier d'entrée dépasse 60, la valeur 60 est utilisée. Valeurs valides : 0 à 60. Unité : FPS.
Gop	String	Non	L'intervalle de temps maximal ou le nombre maximal d'images entre les images clés. Lors de la spécification de l'intervalle de temps maximal, l'unité doit être en secondes. Valeur par défaut : 10s. Lors de la spécification du nombre maximal d'images, aucune unité n'est requise. Valeurs valides : 1 à 100000.
Preset	String	Non	Le préréglage de l'algorithme vidéo. Valeurs valides : veryfast (ultra-rapide), fast (rapide), medium (moyen), slow (lent) et slower (ultra-lent). Valeur par défaut : medium. Ce paramètre est pris en charge uniquement par H.264.
ScanMode	String	Non	Le mode de balayage. Valeurs valides : interlaced et progressive.
Bufsize	String	Non	La taille de la mémoire tampon. Valeurs valides : [1000, 128000]. Valeur par défaut : 6000. Unité : Ko.
Maxrate	String	Non	Le débit binaire vidéo de crête. Valeurs valides : [10, 50000]. Unité : Kbps.
PixFmt	String	Non	Le format de pixel vidéo. Les valeurs valides incluent les formats de pixel standard tels que yuv420p et yuvj420p. Valeur par défaut : yuv420p ou le format de pixel d'origine.
Remove	String	Non	Indique si le flux vidéo doit être supprimé. La valeur true indique que le flux vidéo est supprimé. La valeur false indique que le flux vidéo est conservé. Valeur par défaut : false.
Crop	String	Non	La configuration du recadrage vidéo. Deux méthodes sont prises en charge : la détection et le recadrage automatiques des bandes noires, où la valeur est définie sur border. Le recadrage personnalisé utilise le format de paramètre width:height:left:top. Exemple : 1280:800:0:140.
Pad	String	Non	La configuration du remplissage vidéo. Format du paramètre : width:height:left:top. Exemple : 1280:800:0:140.
LongShortMode	String	Non	Indique si le mode paysage et portrait adaptatif (mode côté long et court) doit être activé. La largeur de la sortie transcodée correspond au côté long de la vidéo d'entrée (la hauteur pour les vidéos en portrait), et la hauteur correspond au côté court de la vidéo d'entrée (la largeur pour les vidéos en portrait). La valeur true indique que la fonction est activée. La valeur false indique que la fonction est désactivée. Valeur par défaut : false.

Le tableau suivant présente les combinaisons prises en charge de codecs de transcodage vidéo et de formats de conteneur :

Conteneur	Codecs audio	Codecs vidéo
flv	AAC, MP3	H.264
mp4	AAC, MP3	H.264, H.265
ts	AAC, MP3	H.264, H.265
m3u8	AAC, MP3	H.264, H.265
gif	Non pris en charge	GIF

Le tableau suivant présente les combinaisons prises en charge de codecs vidéo et de paramètres de configuration de flux vidéo :

Vidéo/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	bgr8

Détails de l'objet JSON Audio

Paramètre	Type	Obligatoire	Description
Codec	String	Non	Le codec audio. Valeurs valides : AAC, MP3, VORBIS et FLAC. Valeur par défaut : AAC.
Profile	String	Non	Le profil d'encodage audio. Lorsque Codec est défini sur AAC, les valeurs valides sont aac_low, aac_he, aac_he_v2, aac_ld et aac_eld.
Samplerate	String	Non	La fréquence d'échantillonnage. Valeur par défaut : 44100. Valeurs valides : 22050, 32000, 44100, 48000 et 96000. Unité : Hz. Si le format de conteneur vidéo est flv et que le codec audio est mp3, les fréquences d'échantillonnage 32000, 48000 et 96000 ne sont pas prises en charge. Si le codec audio est mp3, la fréquence d'échantillonnage 96000 n'est pas prise en charge.
Bitrate	String	Non	Le débit binaire audio du fichier de sortie. Valeurs valides : 8 à 1000. Unité : Kbps. Valeur par défaut : 128.
Channels	String	Non	Le nombre de canaux audio. Valeur par défaut : 2. Lorsque Codec est défini sur mp3, seules les valeurs 1 et 2 sont prises en charge. Lorsque Codec est défini sur aac, seules les valeurs 1, 2, 4, 5, 6 et 8 sont prises en charge.
Remove	String	Non	Indique si le flux audio doit être supprimé. La valeur true indique que le flux audio est supprimé. La valeur false indique que le flux audio est conservé. Valeur par défaut : false.

Le tableau suivant présente les combinaisons prises en charge de codecs de transcodage audio et de formats de conteneur :

Conteneur	Codecs audio
mp3	MP3
mp4	AAC
ogg	VORBIS, FLAC
flac	FLAC

Détails de l'objet JSON TransConfig

Paramètre	Type	Obligatoire	Description
TransMode	String	Non	Le mode de transcodage. Valeur par défaut : onepass. Valeurs valides : onepass, twopass et CBR.
AdjDarMethod	String	Non	La méthode d'ajustement de la résolution. Valeur par défaut : none. Valeurs valides : rescale, crop, pad et none.
IsCheckReso	String	Non	Indique si la résolution doit être vérifiée. Si la résolution de sortie audio est supérieure à la résolution d'entrée en largeur ou en hauteur, la résolution de sortie audio est définie sur la résolution d'entrée. La valeur true indique que la résolution est vérifiée. La valeur false indique que la résolution n'est pas vérifiée. Valeur par défaut : false.
IsCheckResoFail	String	Non	Indique si la résolution doit être vérifiée. Si la résolution de sortie audio est supérieure à la résolution d'entrée en largeur ou en hauteur, le transcodage échoue. La valeur true indique que la résolution est vérifiée. La valeur false indique que la résolution n'est pas vérifiée. Valeur par défaut : false.
IsCheckVideoBitrate	String	Non	Indique si le débit binaire vidéo doit être vérifié. Si le débit binaire vidéo de sortie audio est supérieur au débit binaire vidéo d'entrée, le débit binaire vidéo de sortie audio est défini sur le débit binaire vidéo d'entrée. La valeur true indique que le débit binaire vidéo est vérifié. La valeur false indique que le débit binaire vidéo n'est pas vérifié. Valeur par défaut : false.
IsCheckAudioBitrate	String	Non	Indique si le débit binaire audio doit être vérifié. Si le débit binaire audio de sortie audio est supérieur au débit binaire audio d'entrée, le débit binaire audio de sortie audio est défini sur le débit binaire audio d'entrée. La valeur true indique que le débit binaire audio est vérifié. La valeur false indique que le débit binaire audio n'est pas vérifié. Valeur par défaut : false.
IsCheckAudioBitrateFail	String	Non	Indique si le transcodage doit échouer lorsque le débit binaire audio de sortie audio est supérieur au débit binaire audio source. La valeur true indique que le transcodage n'est pas effectué. La valeur false indique qu'aucune vérification n'est effectuée. Valeur par défaut : false. Ce paramètre est prioritaire sur IsCheckAudioBitrate.
IsCheckVideoBitrateFail	String	Non	Indique si le transcodage doit échouer lorsque le débit binaire vidéo de sortie audio est supérieur au débit binaire vidéo source. La valeur true indique que le transcodage n'est pas effectué. La valeur false indique qu'aucune vérification n'est effectuée. Valeur par défaut : false. Ce paramètre est prioritaire sur IsCheckVideoBitrate.

Détails de l'objet JSON MuxConfig

Paramètre	Type	Obligatoire	Description
Segment	String	Non	La configuration des segments. La valeur est un objet JSON. Pour plus d'informations, consultez Détails des segments.

Détails des segments

Paramètre	Type	Obligatoire	Description
Duration	String	Non	La durée du segment. La valeur doit être un nombre entier. Unité : secondes. Valeurs valides : 1 à 60. Valeur par défaut : 10.
ForceSegTime	String	Non	La liste des temps de segment spécifiés. Séparez les valeurs multiples par des virgules (,). Vous pouvez spécifier jusqu'à 10 temps de segment. La valeur doit être un nombre décimal avec jusqu'à trois décimales. Unité : secondes. Exemple : 23, 55, 60, ce qui indique que les segments sont créés à 23, 55 et 60 secondes.

É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	La configuration du codec vidéo.
Bufsize	string	La taille de la mémoire tampon. Valeur par défaut : 6000. Unité : Ko.	6000
LongShortMode	string	Indique si le mode paysage et portrait adaptatif (mode côté long et court) doit être activé. Valeur par défaut : false. Valeurs valides : true : active le mode paysage et portrait adaptatif. false : désactive le mode paysage et portrait adaptatif. Remarque La largeur de la sortie transcodée correspond au côté long de la vidéo d'entrée (la hauteur pour les vidéos en portrait), et la hauteur correspond au côté court de la vidéo d'entrée (la largeur pour les vidéos en portrait).	false
Degrain	string	Le niveau de contrôle de la qualité vidéo.	10
BitrateBnd	object	La plage de débit binaire vidéo.
Max	string	Le débit binaire maximal.	1500
Min	string	Le débit binaire minimal.	800
PixFmt	string	Le format de pixel vidéo. Les valeurs valides incluent les formats de pixel standard tels que yuv420p et yuvj420p. Valeur par défaut : yuv420p ou le format de pixel d'origine.	yuv420p
Pad	string	La configuration du remplissage vidéo. Format du paramètre : width:height:left:top.	1280:800:0:140
Codec	string	Le format de codec. Valeurs valides : H.264, H.265, GIF et WEBP. Valeur par défaut : H.264.	H.264
Height	string	La hauteur de la vidéo. Unité : pixels. Valeur par défaut : la hauteur de la vidéo d'origine.	800
Qscale	string	L'intensité de l'algorithme de réduction de bruit indépendant.	1
Crop	string	La configuration du recadrage vidéo. Deux méthodes sont prises en charge : Détection et recadrage automatiques des bandes noires : Définissez la valeur sur border. Recadrage personnalisé : Spécifiez des paramètres personnalisés pour le recadrage. Format du paramètre : width:height:left:top. Exemple : 1280:800:0:140.	border
Bitrate	string	Le débit binaire du fichier de sortie. Unité : Kbps.	500
Maxrate	string	Le débit binaire vidéo de crête. Unité : Kbps.	500
MaxFps	string	La fréquence d'images maximale.	60
Profile	string	Le profil d'encodage. baseline : adapté aux appareils mobiles. main : adapté aux appareils à définition standard. high : adapté aux appareils à haute résolution. Valeur par défaut : high. Bonnes pratiques : Si vous avez plusieurs résolutions, définissez la résolution la plus basse sur baseline pour garantir la lecture sur les appareils d'entrée de gamme. Définissez les autres résolutions sur main ou high. Remarque Ce paramètre est pris en charge uniquement par H.264.	high
Crf	string	Le facteur de débit constant (CRF) pour le contrôle du débit binaire et de la qualité. Valeur par défaut : Lorsque le format d'encodage est H.264, la valeur par défaut est 23. Lorsque le format d'encodage est H.265, la valeur par défaut est 26. Remarque Si Crf est défini, les paramètres de débit binaire deviennent invalides.	15
Remove	string	Indique si le flux vidéo doit être supprimé. true : supprime le flux vidéo. false : conserve le flux vidéo. Valeur par défaut : false.	false
Gop	string	L'intervalle de temps maximal ou le nombre maximal d'images entre les images clés. Lors de la spécification de l'intervalle de temps maximal, l'unité doit être en secondes. Lors de la spécification du nombre maximal d'images, aucune unité n'est requise. Valeur par défaut : 10s.	10s
Width	string	La largeur de la vidéo. Valeur par défaut : la largeur de la vidéo d'origine. Unité : pixels.	256
Fps	string	La fréquence d'images. Valeur par défaut : la fréquence d'images du fichier d'entrée. Si la fréquence d'images du fichier d'entrée dépasse 60, la valeur 60 est utilisée. Unité : FPS.	25
Preset	string	Le préréglage de l'algorithme vidéo. Valeur par défaut : medium. Valeurs valides : veryfast : ultra-rapide fast : rapide medium : moyen slow : lent slower : ultra-lent Remarque Ce paramètre est pris en charge uniquement par H.264.	fast
ScanMode	string	Le mode de balayage. Valeurs valides : interlaced : balayage entrelacé progressive : balayage progressif	interlaced
ResoPriority	string	La priorité de l'ajustement de la résolution.	0
Hdr2sdr	string	Indique si la fonction de conversion HDR vers SDR doit être activée. Lorsqu'elle est activée, les vidéos HDR sont converties en SDR.	true
NarrowBand	object	Les paramètres de configuration Narrowband HD.
Version	string	La version Narrowband HD. Valeur valide : 1.0.	1.0
Abrmax	number	La limite supérieure du débit binaire dynamique. Une fois ce paramètre défini, le débit binaire moyen se situe dans la plage (0, 1000000].	3000
MaxAbrRatio	number	Le multiplicateur maximal pour la limite supérieure du débit binaire. Une fois ce paramètre défini, abrmax ne dépasse pas x fois le débit binaire de la vidéo source. Valeurs valides : (0, 1.0].	1.0
TransConfig	object	La configuration générale du transcodage.
IsCheckAudioBitrate	string	Indique si le débit binaire audio doit être vérifié. Si le débit binaire audio de sortie est supérieur au débit binaire audio source, le débit binaire audio de sortie est considéré comme égal au débit binaire audio source, et le paramètre de débit binaire audio spécifié ne prend pas effet. La priorité de ce paramètre est inférieure à celle de IsCheckAudioBitrateFail. true : vérifie le débit binaire audio. false : ne vérifie pas le débit binaire audio. Valeur par défaut : false si le paramètre est vide et que le codec est différent de celui de la source d'entrée. true si le paramètre est vide et que le codec est identique à celui de la source d'entrée.	true
TransMode	string	Le mode de transcodage. Valeurs valides : onepass twopass CBR Valeur par défaut : onepass	onepass
IsCheckReso	string	Indique si la résolution doit être vérifiée. Si la résolution de sortie est supérieure à la résolution d'entrée en largeur ou en hauteur, la résolution de sortie est définie sur la résolution d'entrée. true : vérifie la résolution. false : ne vérifie pas la résolution. Valeur par défaut : false.	true
IsCheckVideoBitrateFail	string	Indique si le débit binaire vidéo doit être vérifié. Si le débit binaire vidéo de sortie est supérieur au débit binaire vidéo source, la priorité de ce paramètre est supérieure à celle de IsCheckVideoBitrate. true : ignore le transcodage. false : ne vérifie pas le débit binaire vidéo. Valeur par défaut : false.	true
AdjDarMethod	string	La méthode d'ajustement de la résolution. Valeur par défaut : none. Valeurs valides : rescale : étire la vidéo pour l'adapter à la résolution. crop : recadre la vidéo par lots. none : n'apporte aucune modification.	rescale
IsCheckVideoBitrate	string	Indique si le débit binaire vidéo doit être vérifié. Si le débit binaire vidéo de sortie est supérieur au débit binaire vidéo d'entrée, le débit binaire vidéo de sortie est défini sur le débit binaire vidéo d'entrée. true : vérifie le débit binaire vidéo. false : ne vérifie pas le débit binaire vidéo. Valeur par défaut : false.	true
IsCheckResoFail	string	Indique si la résolution doit être vérifiée. Si la résolution de sortie est supérieure à la résolution d'entrée en largeur ou en hauteur, un échec de transcodage est renvoyé. true : vérifie la résolution. false : ne vérifie pas la résolution. Valeur par défaut : false.	true
IsCheckAudioBitrateFail	string	Indique si le débit binaire audio doit être vérifié. Si le débit binaire audio de sortie est supérieur au débit binaire audio source, la priorité de ce paramètre est supérieure à celle de IsCheckAudioBitrate. true : ignore le transcodage. false : ne vérifie pas le débit binaire audio. Valeur par défaut : false.	true
State	string	L'état du modèle. Normal : Le modèle est normal. Deleted : Le modèle est supprimé.	Normal
MuxConfig	object	La configuration de multiplexage du transcodage.
Webp	object	La configuration de multiplexage pour WebP.
Loop	string	Le nombre de boucles.	0
Gif	object	La configuration de multiplexage pour GIF.
FinalDelay	string	La durée de pause de la dernière image. Unité : centisecondes.	0
DitherMode	string	La méthode de tramage des couleurs pour la palette. Valeurs valides : sierra et bayer.	sierra
Loop	string	Le nombre de boucles.	0
IsCustomPalette	string	Indique si une palette personnalisée doit être utilisée.	false
Segment	object	La configuration des segments.
Duration	string	La durée du segment. Unité : secondes.	10
Name	string	Le nom du modèle.	mps-example
Audio	object	La configuration du codec audio.
Profile	string	Le profil d'encodage audio. Lorsque Codec est défini sur aac, les valeurs valides sont : aac_low aac_he aac_he_v2 aac_ld aac_eld	aac_low
Remove	string	Indique si le flux audio doit être supprimé. true : supprime le flux audio. false : conserve le flux audio. Valeur par défaut : false.	true
Codec	string	Le format de codec audio. Valeur par défaut : aac. Valeurs valides : aac mp3 vorbis flac	aac
Samplerate	string	La fréquence d'échantillonnage. Unité : Hz. Valeur par défaut : 44100.	44100
Qscale	string	L'intensité de l'algorithme de réduction de bruit indépendant.	5
Channels	string	Le nombre de canaux audio. Valeur par défaut : 2.	2
Volume	object	Les détails du volume.
Method	string	La méthode d'ajustement du volume. Valeurs valides : auto : ajustement automatique dynamic : ajustement dynamique linear : ajustement linéaire	auto
Level	string	Le niveau d'ajustement du volume. Valeur par défaut : -20. Unité : dB.	-20
IntegratedLoudnessTarget	string	Le volume cible. Ce paramètre prend effet uniquement lorsque Method est défini sur dynamic. Unité : dB. Valeurs valides : [-70, -5]. Valeur par défaut : -6.	-6
TruePeak	string	Le volume de crête. Ce paramètre prend effet uniquement lorsque Method est défini sur dynamic. Unité : dB. Valeurs valides : [-9, 0]. Valeur par défaut : -1.	-1
LoudnessRangeTarget	string	La plage de fluctuation par rapport au volume cible. Ce paramètre prend effet uniquement lorsque Method est défini sur dynamic. Unité : dB. Valeurs valides : [1, 20]. Valeur par défaut : 8.	8
PeakLevel	string	Le coefficient d'ajustement du volume. Ce paramètre prend effet uniquement lorsque Method est défini sur adaptive. Valeurs valides : [0, 1]. Valeur par défaut : 0.9.	0.9
Bitrate	string	Le débit binaire audio du fichier de sortie. Unité : Kbps. Valeur par défaut : 128.	500
Id	string	L'identifiant du modèle de transcodage. Conservez cet identifiant pour les appels ultérieurs à d'autres opérations d'API associées.	16f01ad6175e4230ac42bb5182cd****
Container	object	Le conteneur.
Format	string	Le format du conteneur.	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.