Tous les produits
Search
Centre de documentation

Intelligent Media Services:Configuration des effets

Dernière mise à jour :Aug 12, 2026

La structure de l'objet Effect varie selon son type. Chaque section ci-dessous détaille les paramètres propres à un type d'effet spécifique.

Type d'effet : Text (texte en bannière)

Exemple de timeline :Sous-titres et modèles de sous-titres.

Nom

Type

Obligatoire

Description

X

Float

Non

Distance horizontale entre le coin supérieur gauche du texte en bannière et celui de la vidéo de sortie. Cette valeur s'exprime en pourcentage ou en pixels. Une valeur comprise dans l'intervalle [0, 0.9999] correspond à un pourcentage de la largeur de la vidéo. Un entier supérieur ou égal à 2 représente une valeur absolue en pixels. La valeur par défaut est 0. Ces coordonnées sont mises à l'échelle en fonction des dimensions du média source et de la vidéo de sortie.

Y

Float

Non

Distance verticale entre le coin supérieur gauche du texte en bannière et celui de la vidéo de sortie. Cette valeur s'exprime en pourcentage ou en pixels. Une valeur comprise dans l'intervalle [0, 0.9999] correspond à un pourcentage de la hauteur de la vidéo. Un entier supérieur ou égal à 2 représente une valeur absolue en pixels. La valeur par défaut est 0. Ces coordonnées sont mises à l'échelle en fonction des dimensions du média source et de la vidéo de sortie.

TimelineIn

Float

Non

Instant d'apparition du texte en bannière sur la timeline, exprimé en secondes avec une précision de quatre décimales. En l'absence de cette valeur, le système utilise la propriété TimelineIn du clip correspondant.

TimelineOut

Float

Non

Instant de disparition du texte en bannière sur la timeline, exprimé en secondes avec une précision de quatre décimales. Si ce paramètre n'est pas défini, la valeur TimelineOut du clip associé est appliquée automatiquement.

Content

String

Oui

Contenu textuel de la bannière.

Font

String

Non

Police de caractères utilisée pour le texte. Polices prises en charge :Liste des polices. Valeur par défaut : SimSun.

FontSize

Int

Oui

Taille de la police du texte en bannière. Cette taille est ajustée proportionnellement aux dimensions du média source et de la vidéo de sortie. La valeur par défaut est 0 et le maximum autorisé est 5000.

Remarque :

  • Choisissez soit FontSize, soit FixedFontSize. Si les deux sont renseignés, seul FontSize sera pris en compte.

SizeRequestType

String

Non

Méthode de calcul de la taille réelle de rendu du texte à partir de la taille de police spécifiée. La valeur par défaut est RealDim.

  • Nominal : la hauteur rendue du sous-titre en pixels correspond exactement à la valeur FontSize.

  • RealDim : pour certaines polices, la hauteur effective du rendu peut être inférieure à la valeur FontSize.

FixedFontSize

Int

Oui

Taille de police fixe pour le texte en bannière. Contrairement à FontSize, cette valeur n'est pas recalculée en fonction des dimensions du média ou de la vidéo de sortie.

Remarque :

  • Définissez soit FontSize, soit FixedFontSize. En cas de double spécification, FontSize prévaut systématiquement.

FixedX

Float

Non

Position horizontale du coin supérieur gauche du texte par rapport au coin supérieur gauche de la vidéo de sortie. Accepte un pourcentage ou une valeur en pixels. L'intervalle [0, 0.9999] indique un ratio de la largeur vidéo, tandis qu'un entier ≥ 2 définit une position absolue en pixels. Valeur par défaut : 0. Aucune mise à l'échelle n'est appliquée selon la taille du média source.

FixedY

Float

Non

Décalage vertical du texte depuis le coin supérieur gauche de la vidéo de sortie. Exprimé en pourcentage ou en pixels. Une valeur entre 0 et 0.9999 est interprétée comme une fraction de la hauteur vidéo ; un entier ≥ 2 correspond à des pixels absolus. Par défaut à 0, cette coordonnée reste indépendante des dimensions du média d'origine.

FontColor

String

Non

Couleur du texte en bannière, spécifiée par un code hexadécimal précédé d'un dièse (#). Exemple : #ffffff.

FontColorOpacity

String

Non

Niveau d'opacité du texte. Plage autorisée : [0, 1], où 1 signifie totalement opaque et 0 complètement transparent. Valeur par défaut : 1.

FontFace

FontFace

Non

Style typographique appliqué au texte de la bannière.

Spacing

Integer

Non

Espacement inter-caractères du texte, mesuré en pixels. Valeur initiale : 0.

LineSpacing

Integer

Non

Interligne du texte en bannière, exprimé en pixels. Réglage par défaut : 0.

Angle

Float

Non

Angle de rotation antihoraire appliqué au texte. Unité : degrés. Valeur par défaut : 0.

BorderStyle

Int

Non

Format de bordure et d'ombre portée du texte. Options disponibles : 1 (bordure + ombre), 3 (encadré de fond opaque). Valeur par défaut : 1.

Outline

Int

Non

Épaisseur du contour entourant le texte, en pixels. Valeur par défaut : 0.

OutlineColour

String

Non

Teinte du contour du texte, définie par un code couleur hexadécimal préfixé par #. Exemple : #ffffff.

Shadow

Int

Non

Profondeur de l'ombre projetée par le texte, exprimée en pixels. Valeur par défaut : 0.

BackColour

String

Non

Couleur de l'ombre du texte. Utilisez un code hexadécimal commençant par #. Exemple : #ffffff.

Alignment

String

Non

Point d'ancrage du texte dans la vidéo. Valeur par défaut : TopLeft. Options possibles :

  • TopLeft : coin supérieur gauche.

  • TopCenter : centré horizontalement en haut.

  • TopRight : coin supérieur droit.

  • CenterLeft : centré verticalement à gauche.

  • CenterCenter : centre exact de la vidéo.

  • CenterRight : centré verticalement à droite.

  • BottomLeft : coin inférieur gauche.

  • BottomCenter : centré horizontalement en bas.

  • BottomRight : coin inférieur droit.

Pour un positionnement précis selon le mode d'alignement choisi, configurez ce paramètre ainsi :

  • Left : alignement à gauche. Définissez X et Y sur les coordonnées du sommet supérieur gauche du sous-titre par rapport au coin supérieur gauche de la vidéo.

  • Center : alignement central. Attribuez à X et Y les coordonnées de l'intersection entre l'axe central du sous-titre et son bord supérieur, relativement au coin supérieur gauche de la vidéo.

  • Right : alignement à droite. Indiquez dans X et Y la position du sommet supérieur droit du sous-titre par rapport au coin supérieur gauche de la vidéo.

AdaptMode

String

Non

Détermine le comportement d'adaptation lorsque le texte dépasse la largeur de la vidéo ou la valeur TextWidth définie.

  • AutoWrap : retour à la ligne automatique.

  • AutoScale : redimensionnement automatique du texte.

  • AutoWrapAtSpaces : césure uniquement aux espaces. Idéal pour les sous-titres exclusivement en anglais.

TextWidth

String

Non

Largeur de la zone de texte, utilisée uniquement si AdaptMode est activé. Elle sert de référence pour le retour à la ligne ou le redimensionnement automatique. Sans cette valeur, la largeur de la vidéo fait foi. Une valeur > 0 et ≤ 1 représente une proportion de la largeur vidéo ; une valeur > 1 correspond à une taille absolue en pixels.

FontUrl

String

Non

Chemin vers un fichier de police stocké dans votre bucket OSS pour le rendu des sous-titres. Formats acceptés : TTF, OTF et WOFF. Exemple : https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf

EffectColorStyle

String

Non

Style WordArt appliqué au texte en bannière.Exemples d'effets WordArt.

SubtitleEffects

SubtitleEffect[]

Non

Effets multicouches applicables au texte en bannière. Permet d'ajouter plusieurs contours, ombres superposées, un flou gaussien ou un arrière-plan de sous-titre. Le flou gaussien fonctionne uniquement avec le type shadow.

Remarque :

  • L'activation de SubtitleEffects neutralise les champs Outline et Shadow de la piste de sous-titres.

  • Pour les effets multicouches (contour, ombre, fond), l'ordre du tableau SubtitleEffects détermine l'empilement visuel : le premier élément apparaît en bas, le dernier au sommet.

AaiMotionInEffect

String

Non

Animation d'entrée du texte en bannière. Réservé aux sous-titres de type bannière.Exemples d'effets de sous-titres.

AaiMotionIn

Float

Non

Durée de l'animation d'entrée, en secondes (précision de 4 décimales). Par défaut : 0,5 s. Si le texte dure moins de 0,5 s, cette durée équivaut à la durée totale moins celle de l'animation de sortie.

AaiMotionOutEffect

String

Non

Animation de sortie du texte en bannière. Applicable uniquement aux sous-titres de type bannière.Exemples d'effets de sous-titres.

AaiMotionOut

Float

Non

Temps consacré à l'animation de sortie pour les textes en bannière, exprimé en secondes avec quatre décimales. À défaut, le système applique 0,5 s. Pour un texte plus court que 0,5 s, cette valeur couvre l'intégralité de sa durée d'affichage.

AaiMotionLoopEffect

String

Non

Effet d'animation en boucle pour le texte en bannière. Compatible uniquement avec ce type de sous-titre et incompatible avec les animations d'entrée ou de sortie.Exemples d'effets de sous-titres.

Ratio

Float

Non

Vitesse de lecture de l'effet en boucle pour les textes en bannière. Précision : 4 décimales. Défaut : 1. Une valeur supérieure accélère l'animation, tandis qu'une valeur inférieure la ralentit.

TextureURL

String

Non

URL d'une texture appliquée au sous-titre (type bannière uniquement). Formats supportés : PNG, JPG, JPEG, BMP. Seuls les fichiers hébergés sur OSS sont actuellement acceptés. Exemple : https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png

BubbleStyleId

String

Non

Identifiant du style de bulle pour le texte en bannière. Réservé aux sous-titres de type bannière.Exemples de sous-titres en bulle.

BubbleWidth

Float

Non

Largeur de l'arrière-plan en bulle par rapport à la vidéo de sortie. Paramètre valide uniquement pour les sous-titres en bulle. Une valeur > 1 indique des pixels absolus ; ≤ 1 correspond à une proportion relative.

BubbleHeight

Float

Non

Hauteur de l'arrière-plan en bulle relativement à la vidéo de sortie. S'applique exclusivement aux sous-titres en bulle. Valeur > 1 = pixels absolus ; ≤ 1 = ratio relatif.

Type d'effet : DeWatermark (masquage)

Nom

Type

Obligatoire

Description

X

Float

Non

Distance horizontale entre le coin supérieur gauche de la zone floutée et celui de la vidéo de sortie. Accepte un pourcentage ou une valeur en pixels. L'intervalle [0, 0.9999] correspond à un ratio de la largeur vidéo ; un entier ≥ 2 définit une position absolue en pixels. Valeur par défaut : 0.

Y

Float

Non

Décalage vertical depuis le coin supérieur gauche de la vidéo jusqu'à la zone floutée. Peut être exprimé en pourcentage ou en pixels. Les valeurs de 0 à 0.9999 représentent une fraction de la hauteur vidéo ; un entier ≥ 2 correspond à des pixels absolus. Par défaut : 0.

Width

Float

Oui

Largeur de la zone masquée dans la vidéo finale. Saisissez un pourcentage ou une mesure en pixels. La plage [0, 0.9999] indique une proportion de la largeur vidéo, tandis qu'un entier ≥ 2 spécifie une dimension absolue.

Height

Float

Oui

Hauteur de la région floutée dans la vidéo de sortie. Format accepté : pourcentage ou pixels. Une valeur entre 0 et 0.9999 est un ratio de la hauteur vidéo ; ≥ 2 équivaut à une taille fixe en pixels.

Type d'effet : Crop

Exemple de timeline :Recadrage vidéo.

Nom

Type

Obligatoire

Description

X

Float

Non

Position horizontale du coin supérieur gauche de la zone conservée après recadrage, par rapport au coin supérieur gauche de la vidéo de sortie. Valeur en pourcentage ou en pixels. L'intervalle [0, 0.9999] représente une fraction de la largeur vidéo ; un entier ≥ 2 correspond à une coordonnée absolue. Défaut : 0.

Y

Float

Non

Ordonnée du coin supérieur gauche de la portion visible après découpe, mesurée depuis le coin supérieur gauche de la vidéo. Exprimable en pourcentage ou en pixels. La plage [0, 0.9999] correspond à un ratio de hauteur ; ≥ 2 indique une valeur absolue. Valeur par défaut : 0.

Width

Float

Oui

Dimension horizontale de la zone retenue dans la vidéo finale. Renseignez un pourcentage ou une valeur en pixels. Les nombres de 0 à 0.9999 sont interprétés comme une proportion de la largeur vidéo ; un entier ≥ 2 définit une largeur fixe.

Height

Float

Oui

Hauteur de la région conservée suite au recadrage. Accepte un ratio (0 à 0.9999 de la hauteur vidéo) ou une mesure absolue en pixels (entier ≥ 2).

Type d'effet : Scale (mise à l'échelle)

Si le format du média diffère de celui de la vidéo cible et qu'aucun effet de mise à l'échelle n'est appliqué, le système adapte automatiquement le média à la largeur ou à la hauteur, le centre, puis comble les bandes restantes avec du noir.

Exemple de timeline :Configuration de la mise à l'échelle.

Nom

Type

Obligatoire

Description

Width

Float

Oui

Largeur de la zone affichée après redimensionnement. Fournissez un pourcentage ou une valeur en pixels. La plage [0, 0.9999] correspond à une fraction de la largeur vidéo ; tout entier ≥ 1 représente une dimension absolue.

Height

Float

Oui

Hauteur résultante dans la vidéo de sortie après application de l'effet. Exprimable en pourcentage (0 à 0.9999 de la hauteur vidéo) ou en pixels absolus (entier ≥ 1).

Type d'effet : Pad (remplissage)

En l'absence d'effet de remplissage explicite, un média dont le ratio ne correspond pas à la vidéo de sortie sera automatiquement ajusté à la largeur ou à la hauteur, centré, et les espaces vides seront remplis par des bandes noires.

Exemple de timeline :Conversion paysage vers portrait avec remplissage flouté.

Nom

Type

Obligatoire

Description

Left

Float

Non

Marge gauche entre le média et le bord gauche de la vidéo de sortie. Accepte un pourcentage ou des pixels. Intervalle [0, 0.9999] = ratio de largeur vidéo ; entier ≥ 1 = valeur absolue.

Right

Float

Non

Espace réservé à droite du média jusqu'au bord droit de la vidéo. Format : pourcentage ou pixels. De 0 à 0.9999, il s'agit d'une proportion de la largeur ; ≥ 1 correspond à une marge fixe.

Top

Float

Non

Écart vertical entre le haut du média et le bord supérieur de la vidéo. Renseignez un ratio (0–0.9999 de la hauteur vidéo) ou une distance en pixels (≥ 1).

Bottom

Float

Non

Padding inférieur séparant le bas du média du bord inférieur de la vidéo. Valeur admise : pourcentage de la hauteur vidéo (0–0.9999) ou pixels absolus (≥ 1).

Color

String

Non

Teinte de remplissage des marges. Code hexadécimal préfixé par #. Exemple : #000000. Noir par défaut.

Type d'effet : Background (paramètres d'arrière-plan)

Les options d'arrière-plan permettent d'appliquer un flou ou une couleur unie pour combler les zones vides lorsque les dimensions du média et de la vidéo diffèrent.

Compatible avec les effets Crop, Scale, VFX et Transition.

Exemple de timeline :Conversion paysage/portrait avec couleur d'arrière-plan personnalisée.

Nom

Type

Obligatoire

Description

SubType

String

Oui

Variante de l'effet d'arrière-plan. Options :

Blur : arrière-plan flouté.

Color : couleur d'arrière-plan unie.

Radius

Float

Non

Rayon du flou appliqué. Paramètre actif uniquement lorsque SubType vaut Blur. Plage autorisée : [0.01, 1].

Color

String

Non

Code couleur RGB hexadécimal de l'arrière-plan. Utilisé seulement si SubType est Color. Exemple : #FFFFFF.

Type d'effet : Transition

Important

Cet effet de transition repose sur le chevauchement de deux clips, ce qui réduit la durée totale de la vidéo finale. Pour conserver la durée originale, privilégiez l'effet DLTransition décrit ci-après.

Une transition s'insère entre deux clips consécutifs et se configure uniquement sur le premier. Elle superpose la fin du clip 1 avec le début du clip 2, diminuant ainsi la longueur globale de la vidéo d'une durée équivalente à celle de la transition.

Prenons l'exemple d'une piste vidéo contenant Clip1 (10 s) et Clip2 (8 s). L'ajout d'une transition de 4 s ramène la durée totale de la piste à 14 s au lieu de 18 s.

Le tableau suivant présente les propriétés génériques des transitions. Pour consulter les effets spécifiques :Exemples d'effets de transition.

Exemple de timeline :Exemple de configuration de transition dans une timeline.

Nom

Type

Obligatoire

Description

SubType

String

Oui

Sous-type de transition. Indiquez un ou plusieurs sous-types séparés par des virgules ; le système en sélectionnera un aléatoirement. Vous pouvez aussi utiliser random pour choisir parmi toutes les transitions disponibles. Exemple : directional. Consultez la liste complète des valeurs et rendus :Exemples d'effets de transition.

Duration

Float

Non

Longueur temporelle de la transition, en secondes, avec une précision de quatre décimales. Valeur par défaut : 1 s.

Type d'effet : DLTransition (transition à durée verrouillée)

Contrairement à l'effet Transition classique, le Duration Lock Transition (DLTransition) préserve intégralement la durée de la vidéo finale en comblant la période de transition avec des images fixes.

Les paramètres de DLTransition sont identiques à ceux de Transition.

Nom

Type

Obligatoire

Description

SubType

String

Oui

Variante de transition souhaitée. Listez un ou plusieurs sous-types séparés par des virgules pour une sélection aléatoire, ou utilisez random pour piocher parmi l'ensemble des transitions. Exemple : directional. Voir tous les styles disponibles :Exemples d'effets de transition.

Duration

Float

Non

Temps alloué à la transition, exprimé en secondes (4 décimales). Par défaut : 1 s.

Type d'effet : VFX

Exemple de timeline :VFX.

Nom

Type

Obligatoire

Description

SubType

String

Oui

Sous-type de l'effet. Spécifiez un ou plusieurs sous-types d'effet, séparés par des virgules (,). Un sous-type est sélectionné aléatoirement dans la liste. Vous pouvez également spécifier random pour choisir un sous-type au hasard parmi tous les effets disponibles. Exemple : colorfulradial. Toutes les valeurs et tous les effets sont détaillés ici :Exemples d'effets.

X

Float

Non

Ce champ n'est valide que lorsque SubType est défini sur mosaic_rect ou blur. Il définit la distance horizontale entre le coin supérieur gauche de la zone d'effet et le coin supérieur gauche de la vidéo de sortie.

Remarque : La valeur peut être exprimée en pourcentage ou en pixels. Une valeur comprise dans l'intervalle [0, 0,9999] correspond à un pourcentage de la largeur de la vidéo de sortie. Une valeur entière supérieure ou égale à 2 représente une valeur absolue en pixels.

Y

Float

Non

Ce champ n'est valide que lorsque SubType est défini sur mosaic_rect ou blur.

Il indique la distance verticale entre la zone d'effet et le coin supérieur gauche de la vidéo de sortie. Remarque : La valeur peut être exprimée en pourcentage ou en pixels. Une valeur comprise dans l'intervalle [0, 0,9999] correspond à un pourcentage de la hauteur de la vidéo de sortie. Une valeur entière supérieure ou égale à 2 représente une valeur absolue en pixels.

Width

Float

Non

Ce champ n'est valide que lorsque SubType est défini sur mosaic_rect ou blur. Il détermine la largeur de la zone d'effet dans la vidéo de sortie. Remarque : La valeur peut être exprimée en pourcentage ou en pixels. Une valeur comprise dans l'intervalle [0, 0,9999] correspond à un pourcentage de la largeur de la vidéo de sortie. Une valeur entière supérieure ou égale à 2 représente une valeur absolue en pixels.

Height

Float

Non

Ce champ n'est valide que lorsque SubType est défini sur mosaic_rect ou blur. Il détermine la hauteur de la zone d'effet dans la vidéo de sortie. Remarque : La valeur peut être exprimée en pourcentage ou en pixels. Une valeur comprise dans l'intervalle [0, 0,9999] correspond à un pourcentage de la hauteur de la vidéo de sortie. Une valeur entière supérieure ou égale à 2 représente une valeur absolue en pixels.

ExtParams

String

Non

Paramètres étendus de l'effet. Ce champ s'applique uniquement aux scénarios de masquage, lorsque SubType prend la valeur mask_circle, mask_rec, mask_linear ou mask_minor. Les paramètres de configuration de ExtParams pour ces scénarios sont décrits ci-dessous.

Exemples de masquage et effets obtenus :Effets de masquage.

Important

Pour les paramètres de masque suivants, vous devez spécifier des valeurs décimales au format à virgule flottante, telles que 0,5 ou 2,0.

Paramètres des effets de masque circulaire

SubType=mask_circle

Description des paramètres ExtParams

Paramètre

Type

Plage de valeurs

Valeur par défaut

Description

x

float

[0.0, material width]

0.5

Coordonnée X du centre du masque par rapport au coin supérieur gauche du média source. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une coordonnée relative à la largeur du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels.

y

float

[0.0, material height]

0.5

Coordonnée Y du centre du masque par rapport au coin supérieur gauche du média source. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une coordonnée relative à la hauteur du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels.

width

float

[0.0, material width]

0.8

Largeur du masque elliptique par rapport à celle du média source. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une largeur relative. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels.

height

float

[0.0, material height]

0.8

Hauteur du masque elliptique par rapport à celle du média source. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une hauteur relative. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels.

antialias

float

[0.0, 1.0]

0.1

Paramètre d'anticrénelage du masque elliptique. Plus cette valeur est élevée, plus le flou appliqué aux contours est important.

angle

float

[-9999.0, 9999.0]

0.0

Angle de rotation.

Paramètres des effets de masque rectangulaire

SubType=mask_rec

Description des paramètres ExtParams

Paramètre

Type

Plage de valeurs

Valeur par défaut

Description

x

float

[0.0, material width]

0.5

Coordonnée X du centre du masque rectangulaire dans le média vidéo, par rapport au coin supérieur gauche du média. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une coordonnée relative à la largeur du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels.

y

float

[0.0, material height]

0.5

Coordonnée Y du centre du masque rectangulaire dans le média vidéo, par rapport au coin supérieur gauche du média. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une coordonnée relative à la hauteur du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels.

width

float

[0.0, material width]

0.8

Largeur du masque rectangulaire. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une largeur relative à celle du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels.

height

float

[0.0, material height]

0.8

Hauteur du masque rectangulaire. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une hauteur relative à celle du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels.

antialias

float

[0.0, 1.0]

0.1

Paramètre d'anticrénelage du masque rectangulaire. Plus cette valeur est élevée, plus le flou appliqué aux contours est important.

radius

float

[0.0, the larger of the material's width or height]

0.1

Rayon des coins du masque rectangulaire. Une valeur comprise dans l'intervalle [0.0, 1.0] représente un rayon relatif à la plus grande dimension (largeur ou hauteur) du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels.

angle

float

[-9999.0, 9999.0]

0.0

Angle de rotation.

Paramètres des effets de masque linéaire

SubType=mask_linear

Description des paramètres ExtParams

Paramètre

Type

Plage de valeurs

Valeur par défaut

Description

x

float

[0.0, material width]

0.5

Coordonnée X du point de référence central du masque linéaire, par rapport au coin supérieur gauche du média. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une coordonnée relative à la largeur du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels.

y

float

[0.0, material height]

0.5

Coordonnée Y du point de référence central du masque linéaire dans le média vidéo, par rapport au coin supérieur gauche de la vidéo. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une coordonnée relative à la largeur du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels.

antialias

float

[0.0, 1.0]

0.1

Paramètre d'anticrénelage du masque linéaire. Plus cette valeur est élevée, plus le flou appliqué aux contours est important.

angle

float

[-9999.0, 9999.0]

0.0

Angle de rotation.

Paramètres des effets de masque miroir

SubType=mask_minor

Description des paramètres ExtParams

Paramètre

Type

Plage de valeurs

Valeur par défaut

Description

x

float

[0.0, material width]

0.5

Coordonnée X du point de référence central du masque miroir, par rapport au coin supérieur gauche du média. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une coordonnée relative à la largeur du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels.

y

float

[0.0, material height]

0.5

Coordonnée Y du point de référence central du masque miroir, par rapport au coin supérieur gauche du média. Une valeur comprise dans l'intervalle [0.0, 1.0] représente une coordonnée relative à la hauteur du média. Une valeur supérieure à 1.0 correspond à une valeur absolue en pixels.

antialias

float

[0.0, 1.0]

0.1

Paramètre d'anticrénelage du masque miroir. Plus cette valeur est élevée, plus le flou appliqué aux contours est important.

angle

float

[-9999.0, 9999.0]

0.0

Angle de rotation.

Type d'effet : Filter

Exemple de timeline :Filter.

Nom

Type

Obligatoire

Description

SubType

String

Oui

Sous-type du filtre. Spécifiez un ou plusieurs sous-types de filtre, séparés par des virgules (,). Un sous-type est sélectionné aléatoirement dans la liste. Vous pouvez également spécifier random pour choisir un sous-type au hasard parmi tous les filtres disponibles. Exemple : M1. Toutes les valeurs et tous les effets sont détaillés ici :Exemples d'effets de filtre.

TimelineIn

Float

Non

Moment où le filtre est appliqué sur la timeline. Unité : secondes. La valeur est précise jusqu'à quatre décimales. Si ce paramètre n'est pas spécifié, la valeur TimelineIn du clip correspondant est utilisée.

TimelineOut

Float

Non

Moment où le filtre est retiré de la timeline. Unité : secondes. La valeur est précise jusqu'à quatre décimales. Si ce paramètre n'est pas spécifié, la valeur TimelineOut du clip correspondant est utilisée.

ExtParams

String

Non

Paramètres étendus du filtre. Ce champ n'est valide que lorsque SubType est défini sur color, ce qui applique un filtre colorimétrique. Les paramètres de configuration de ExtParams pour un filtre colorimétrique sont décrits ci-dessous.

Paramètres ExtParams du filtre colorimétrique

Exemple de timeline :Utiliser des filtres colorimétriques.

Description des paramètres ExtParams

Paramètre

Type

Plage de valeurs

Description

Valeur par défaut

brightness

int

[-255,255]

Luminosité

0

contrast

int

[-100,100]

Contraste

0

saturation

int

[-100,100]

Saturation

0

kelvin_temperature

int

[1000,40000]

Température de couleur. Ce paramètre fonctionne conjointement avec

le paramètre temperature_ratio.

6000

temperature_ratio

int

[0,100]

Ratio de température.

0

tint

int

[-100,100]

Teinte

0

dark_corner_ratio

int

[0,100]

Ratio de vignettage.

0

Type d'effet : Volume (ajustement du volume)

Exemples de timeline :Couper le son d'une vidéo entière et Ajuster le volume vidéo et audio.

Nom

Type

Obligatoire

Description

Gain

Float

Non

Gain du volume. Plage : [0, 10]. 0 = muet, 1 = volume original, inférieur à 1 = plus faible, supérieur à 1 = plus fort. Valeur par défaut : 1. Des valeurs excessivement élevées peuvent provoquer une distorsion.

Type d'effet : AFade (fondu audio)

Exemple de timeline :Configurer le fondu entrant et sortant pour les clips audio uniquement et l'audio des vidéos.

Nom

Type

Obligatoire

Description

SubType

String

Oui

Sous-type du fondu audio. Valeurs valides :

  • In (fondu entrant)

  • Out (fondu sortant)

Duration

Float

Non

Durée du fondu. Un fondu entrant s'applique au début du clip, tandis qu'un fondu sortant s'applique à la fin. La valeur par défaut est 0, ce qui désactive l'effet.

Curve

String

Non

Courbe de volume pour le fondu audio. La valeur par défaut est exp.

Valeurs valides :

  • exp (courbe de volume exponentielle)

  • tri (courbe de volume linéaire)

Type d'effet : AI_ASR (reconnaissance vocale)

Cet effet génère des sous-titres à partir de l'audio. Vous pouvez placer cet effet dans l'objet Effects d'une piste vidéo ou audio. Les paramètres sont identiques à ceux décrits dans la section Type d'effet : Text (texte superposé). Par défaut, les sous-titres sont centrés en bas de la vidéo. Cette fonctionnalité est disponible uniquement dans les régions Chine (Pékin), Chine (Shanghai) et Chine (Hangzhou).

Nom

Type

Obligatoire

Description

X

Float

Non

Distance horizontale entre le coin supérieur gauche du texte superposé et le coin supérieur gauche de la vidéo de sortie. La valeur peut être exprimée en pourcentage ou en pixels. Une valeur comprise dans l'intervalle [0, 0,9999] correspond à un pourcentage de la largeur de la vidéo de sortie. Une valeur entière supérieure ou égale à 2 représente une valeur absolue en pixels.

Y

Float

Non

Distance verticale entre le coin supérieur gauche du texte superposé et le coin supérieur gauche de la vidéo de sortie. La valeur peut être exprimée en pourcentage ou en pixels. Une valeur comprise dans l'intervalle [0, 0,9999] correspond à un pourcentage de la hauteur de la vidéo de sortie. Une valeur entière supérieure ou égale à 2 représente une valeur absolue en pixels.

Font

String

Non

Police du texte superposé. Polices prises en charge :Liste des polices. Valeur par défaut : SimSun.

FontSize

Int

Oui

Taille de police du texte superposé.

FontColor

String

Non

Couleur du texte superposé. La valeur est un code couleur hexadécimal commençant par un dièse (#). Exemple : #ffffff.

FontColorOpacity

String

Non

Opacité du texte superposé. Plage : [0, 1]. 1 = opaque, 0 = totalement transparent. Valeur par défaut : 1.

FontFace

FontFace

Non

Style de police du texte superposé.

NeedHighlighting

Boolean

Non

Indique si le surlignage automatique des sous-titres ASR doit être activé.

HighlightingStyle

Style

Non

Style appliqué aux sous-titres surlignés.

Type d'effet : Rotate (rotation du média)

Cet effet fait pivoter un média selon un angle spécifié. Seuls les angles de 90, 180 et 270 degrés sont pris en charge. Il s'applique aux médias situés sur des pistes vidéo ou image.

Exemple de timeline :Rotation du média.

Nom

Type

Obligatoire

Description

Degree

Integer

Oui

Angle de rotation horaire du média. Seuls les angles de 90, 180 et 270 degrés sont pris en charge.

Type d'effet : AI_Matting (incrustation sur fond vert)

Cet effet extrait un sujet d'un arrière-plan vert ou bleu pour le superposer à une autre vidéo ou image d'arrière-plan. Cette fonctionnalité est disponible uniquement dans les régions Chine (Pékin), Chine (Shanghai) et Chine (Hangzhou).

Nom

Type

Obligatoire

Description

Color

String

Oui

Couleur d'arrière-plan à supprimer. Seules les valeurs green (incrustation sur fond vert) et blue (incrustation sur fond bleu) sont prises en charge.

Auto

Integer

Oui

Indique si la couleur d'arrière-plan doit être détectée automatiquement. Valeurs valides :

  • 0 : Détection basée sur le seuil.

  • 1 : Détection automatique.

Thres

Float

Non

Seuil de détection de la couleur d'arrière-plan. Une valeur plus élevée rend la détection moins stricte. La valeur doit se situer dans l'intervalle [0, 10].

Type d'effet : AI_RealMatting (incrustation en environnement réel)

Cet effet extrait une personne d'une scène réelle dans une vidéo pour la superposer à une autre vidéo ou image d'arrière-plan. Cette fonctionnalité est disponible uniquement dans les régions Chine (Pékin), Chine (Shanghai) et Chine (Hangzhou).

Nom

Type

Obligatoire

Description

Thres

Float

Non

Seuil de détection de la couleur d'arrière-plan. Une valeur plus élevée rend la détection moins stricte. La valeur doit se situer dans l'intervalle [0, 10]. La valeur par défaut est 2.

Type d'effet : AI_Delogo (suppression intelligente de logo)

Cet effet reconnaît et supprime intelligemment les logos présents dans les vidéos. Cette fonctionnalité est disponible uniquement dans les régions Chine (Pékin) et Chine (Shanghai).

Type d'effet : Clip (clip aléatoire)

Cet effet prélève aléatoirement un segment du média source pour l'ajouter à la timeline.

Nom

Type

Obligatoire

Description

SubType

String

Oui

Type de découpage. Seul le découpage aléatoire est pris en charge : RandomClip.

ClipDuration

Float

Oui

Durée du segment découpé.

Type d'effet : Flip

Vous pouvez retourner les vidéos ou images d'une piste vidéo horizontalement ou verticalement.

Exemple de timeline :Retournement horizontal et vertical.

Nom

Type

Obligatoire

Description

Direction

String

Oui

  • horizontal : Retournement horizontal.

  • vertical : Retournement vertical.

Type d'effet : KenBurns (effet Ken Burns)

Cet effet applique un effet Ken Burns à une vidéo ou une image située sur une piste vidéo.

Limites :

  • Cet effet s'applique aux images et aux vidéos. Il est compatible avec les effets visuels, les filtres et les transitions.

  • Puisque cet effet permet de définir la largeur et la hauteur du cadre de sortie via les paramètres WindowW et WindowH, il est incompatible avec les effets Crop, Scale, Pad ou Background.

Nom

Type

Obligatoire

Description

Exemple

Duration

Float

Non

Durée de l'effet. La valeur par défaut correspond à la durée du clip. La valeur maximale est de 10. Unité : secondes (s).

5

WindowW

Float

Non

Largeur du clip. Par défaut, cette valeur est égale à la largeur de la vidéo de sortie. Unité : pixels.

Une valeur comprise dans l'intervalle 0 < WindowW <= 1 est une valeur relative. Une valeur supérieure à 1 est une valeur absolue.

1

WindowH

Float

Non

Hauteur du clip. Par défaut, cette valeur correspond à la hauteur de la vidéo de sortie. Unité : pixels.

Si la valeur de WindowH se situe dans l'intervalle (0,1], il s'agit d'une valeur relative.

> Une valeur de 1 indique une valeur absolue.

1

Start

String

Non

Position de la zone d'effet avant l'application de l'effet Ken Burns. Cette position est définie par les coordonnées x et y du coin supérieur gauche ainsi que par la largeur et la hauteur de la zone d'effet. Ces paramètres sont facultatifs. Les valeurs doivent être séparées par des virgules (,).

"StartX, StartY, StartW, StartH"

Limites :

0 < StartX + StartW <=1

0 < StartY + StartH <=1

"0,0,0.9,0.9"

StartX

Float

Non

Coordonnée x du coin supérieur gauche de la zone d'effet avant l'application de l'effet Ken Burns. Unité : pixels.

Si la valeur du paramètre StartX se situe dans l'intervalle [0,1), il s'agit d'une valeur relative.

Une valeur supérieure ou égale à 1 indique une valeur absolue.

0

StartY

Float

Non

Coordonnée y du coin supérieur gauche de la zone d'effet avant l'application de l'effet Ken Burns. Unité : pixels.

Si la valeur du paramètre StartY se situe dans l'intervalle [0,1), il s'agit d'une valeur relative.

La valeur absolue doit être supérieure ou égale à 1.

0

StartW

Float

Non

Largeur de la zone d'effet avant l'application de l'effet Ken Burns. Unité : pixels.

Si la valeur du paramètre StartW se situe dans l'intervalle (0,1], il s'agit d'une valeur relative.

> Une valeur de 1 indique une valeur absolue.

0.9

StartH

Float

Non

Hauteur de la zone d'effet avant l'application de l'effet Ken Burns. Unité : pixels.

Si la valeur du paramètre StartH se situe dans l'intervalle (0,1], il s'agit d'une valeur relative.

> Une valeur supérieure à 1 indique une valeur absolue.

0.9

End

String

Non

Position de la zone d'effet après l'application de l'effet Ken Burns. Cette position est définie par les coordonnées x et y du coin supérieur gauche ainsi que par la largeur et la hauteur de la zone d'effet. Ces paramètres sont facultatifs. Les valeurs doivent être séparées par des virgules (,).

"EndX, EndY, EndW, EndH"

Limites :

0 < EndX + EndW <=1

0 < EndY + EndH <=1

"0,0,1,1"

EndX

Float

Non

Coordonnée x du coin supérieur gauche de la zone d'effet après l'application de l'effet Ken Burns. Unité : pixels.

Si la valeur du paramètre StartX se situe dans l'intervalle [0,1), il s'agit d'une valeur relative.

La valeur absolue doit être supérieure ou égale à 1.

0

EndY

Float

Non

Coordonnée y du coin supérieur gauche de la zone d'effet après l'application de l'effet Ken Burns. Unité : pixels.

Si la valeur du paramètre StartY se situe dans l'intervalle [0,1), il s'agit d'une valeur relative.

La valeur absolue doit être supérieure ou égale à 1.

0

EndW

Float

Non

Largeur de la zone d'effet après l'application de l'effet Ken Burns. Unité : pixels.

Si la valeur du paramètre StartW se situe dans l'intervalle (0,1], il s'agit d'une valeur relative.

> Une valeur de 1 indique une valeur absolue.

1

EndH

Float

Non

Hauteur de la zone d'effet après l'application de l'effet Ken Burns. Unité : pixels.

Si la valeur du paramètre StartH se situe dans l'intervalle (0,1], il s'agit d'une valeur relative.

> Une valeur supérieure à 1 spécifie une valeur absolue.

1

Type d'effet : ADenoise (réduction du bruit audio)

Vous pouvez appliquer cet effet aux vidéos contenant de l'audio sur une piste vidéo, ou aux clips audio sur une piste audio.

Nom

Type

Obligatoire

Description

Mode

Integer

Non

  • 0 : Aucun traitement (par défaut).

  • 1 : Réduction légère du bruit.

  • 2 : Préservation de la musique tout en éliminant le bruit stationnaire. Convient au contenu musical.

  • 3 : Élimination forte du bruit stationnaire. Recommandé pour le contenu vocal sans musique.

  • 4 : Extraction de la voix. Supprime le bruit stationnaire et non stationnaire. Adapté au contenu non musical.

Type d'effet : Zoom

Cet effet ajoute un zoom au clip correspondant.

Important

Cet effet est pris en charge uniquement pour les clips d'une VideoTrack.

Nom

Type

Obligatoire

Description

StartRate

Float

Non

  • Rapport de zoom initial.

  • Valeur par défaut : 1.0.

  • Plage de valeurs : [1.0, 5.0].

EndRate

Float

Non

  • Rapport de zoom final.

  • Valeur par défaut : StartRate + 0.3.

  • Plage de valeurs : [StartRate, 5.0].

Duration

Float

Non

  • Durée de l'effet.

  • Valeur par défaut : Durée de rendu du clip actuel.

  • Plage de valeurs : [0, durée de rendu du clip actuel].

Type d'effet : Harmonization (harmonisation de l'arrière-plan)

Cet effet applique une harmonisation de l'arrière-plan au clip correspondant et est principalement destiné aux clips vidéo d'humains numériques. Lorsqu'il est appliqué à un clip d'humain numérique, l'éclairage, la luminosité et la température des couleurs du clip sont ajustés pour correspondre à l'image d'arrière-plan. Cela réduit les incohérences visuelles entre le clip d'humain numérique et l'arrière-plan.

Important
  1. Cet effet est pris en charge uniquement pour les clips d'une VideoTrack.

  2. Vous ne pouvez ajouter qu'un seul effet d'harmonisation par requête de montage vidéo.

Aucun autre paramètre d'entrée n'est requis pour cet effet.

Type d'effet : ALoudNorm (normalisation du volume)

L'effet ALoudNorm s'applique à un seul fichier audio ou vidéo. Si vous disposez de plusieurs fichiers audio ou vidéo et souhaitez qu'ils partagent le même niveau sonore, vous devez configurer ALoudNorm séparément sur chaque fichier.

Remarque

Cet effet s'applique uniquement aux clips audio et vidéo. Si ALoudNorm est utilisé conjointement avec ADenoise ou Volume, les effets sont appliqués dans l'ordre suivant : ADenoise > Volume > ALoudNorm.

Exemple de timeline :Normalisation du volume.

Nom

Type

Obligatoire

Description

Loudness

Float

Non

Niveau sonore cible qui détermine le volume et respecte la norme EBU R128. Plage de valeurs : [-70.0, -5.0]. Valeur par défaut : -24.0.

TruePeak

Float

Non

Niveau de crête réel qui limite le niveau de crête maximal du signal audio. Plage de valeurs : [-9.0, +0.0]. Valeur par défaut : -2.0.

Type d'effet : AEqualize (égalisation du volume)

Il s'agit d'un effet global qui s'applique à la piste d'effets. Il applique une égalisation uniforme du volume au mixage audio final.

Remarque

Cet effet est global et ne peut pas être appliqué à un seul clip.

Exemple de timeline :Égalisation du volume.

Nom

Type

Obligatoire

Description

Peak

Float

Non

Niveau de crête cible de l'audio. La valeur par défaut est 0.95. Ne dépassez pas cette valeur.

La valeur doit se situer dans l'intervalle ouvert (0, 1).

Gain

Float

Non

Coefficient de gain maximal. La valeur doit se situer dans la plage [1.0, 100.0]. La valeur par défaut est 10.0.

Le normalisateur audio dynamique détermine le facteur de gain maximal possible (local) pour chaque trame d'entrée afin d'éviter tout écrêtage ou distorsion.

Type d'effet : FreezeFrame (arrêt sur image)

Cet effet s'applique aux contenus vidéo sur une piste vidéo et crée un arrêt sur image à partir de la dernière trame de la vidéo.

Remarque

Cet effet s'applique uniquement aux contenus vidéo sur une piste vidéo. Il ne fonctionne ni sur les images fixes d'une piste vidéo, ni sur les contenus d'une piste audio.

Cet effet est incompatible avec l'effet Type d'effet : Transition.

Exemple de timeline :Arrêt sur image vidéo.

Nom

Type

Obligatoire

Description

Duration

Float

Non

Durée de l'arrêt sur image. La valeur par défaut est 0. Unité : secondes (s).