Tous les produits
Search
Centre de documentation

ApsaraVideo VOD:Exemples de configuration de la timeline

Dernière mise à jour :Aug 10, 2026

Lorsque vous soumettez un job de production contenant des données de timeline, vous devez configurer le paramètre Timeline. Cette rubrique propose des exemples de configuration de Timeline pour le montage vidéo, la création de sous-titres et la réalisation d'albums photo.

Description

Pour plus d'informations sur les paramètres présentés dans les exemples ci-dessous, consultez Timeline : informations sur la timeline d'un projet de montage en ligne.

Montage vidéo

Ajouter un sous-titre au centre

Pour ajouter un sous-titre centré en haut d'une vidéo, spécifiez "Alignment": "TopCenter" et définissez Y comme la distance entre le texte du sous-titre et le haut de l'écran.

{
  "VideoTracks": [
    {
      "VideoTrackClips": [
        {
          "MediaId": "4bcf9b4d7cf14dc7b83b0e801cbe****",
          "Effects": [
            {
              "Type": "Text",
              "X": 20,
              "Y": 34,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "Top Center - A timeline is created when you add materials and configure special effects to create a video. ",
              "Alignment": "TopCenter",
              "FontSize": 26,
              "FontColorOpacity": 1,
              "FontColor": "#ff0000",
              "FontFace": {
                "Bold": true,
                "Italic": false,
                "Underline": false
              }
            },
            {
              "Type": "Text",
              "X": 100,
              "Y": 200,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "Center Center - A timeline consists of tracks, materials, and effects.",
              "Alignment": "CenterCenter",
              "FontSize": 26,
              "FontColorOpacity": 0.8,
              "FontColor": "#ff0000"
            },
            {
              "Type": "Text",
              "X": 0.10,
              "Y": 0.1,
              "TimelineIn": 2,
              "TimelineOut": 15,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "Bottom Center - A timeline is created when you add materials and configure special effects to create a video. A timeline consists of tracks, materials, and effects.",
              "Alignment": "BottomCenter",
              "FontSize": 26,
              "FontColor": "#000000"
            }
          ]
        }
      ]
    }
  ]
}
Remarque
  • Valeurs valides pour Alignment : BottomLeft, BottomCenter, BottomRight, CenterLeft, CenterCenter, CenterRight, TopLeft, TopCenter et TopRight.

  • Si le paramètre Effects inclut Alignment, X représente la distance entre le texte du sous-titre et le côté gauche de l'écran, tandis que Y indique la distance entre le texte du sous-titre et le haut de l'écran.

Ajouter un filigrane et spécifier l'emplacement, l'heure de début et l'heure de fin

{
    "VideoTracks":[
        {
            "VideoTrackClips":[
                {
                    "MediaId":"756620ed48c9af022c66ee1cbe2e****",
                    "Type":"Video",
                    "TimelineIn":0,
                    "TimelineOut":140,
                    "Duration":140
                }
            ]
        },
        {
            "VideoTrackClips":[
                {
                    "Effects":[
                        {
                            "Type":"Scale",
                            "TimelineIn":0,
                            "TimelineOut":100,
                            "Width":0.416,
                            "Height":0.2347
                        }
                    ],
                    "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
                    "Type":"Image",
                    "TimelineIn":0,
                    "TimelineOut":100,
                    "Duration":100,
                    "X":0.584,
                    "Y":0
                }
            ]
        }
    ]
}

Ajouter un filigrane sans spécifier la durée

Utilisez ImageTracks pour configurer un filigrane sans indiquer de durée. Le filigrane reste affiché pendant toute la vidéo.

{
    "VideoTracks":[
        {
            "Count":3,
            "VideoTrackClips":[
                {
                    "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
                    "Type":"Image",
                    "Duration":5
                },
                {
                    "MediaId":"756620ed48c9af022c66ee1cbe2e****",
                    "Type":"Image",
                    "Duration":5
                },
                {
                    "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
                    "Type":"Image",
                    "Duration":5
                }
            ]
        }
    ],
    "ImageTracks": [
        {
            "ImageTrackClips": [
                {
                    "ImageId": "756620ed48c9af022c66ee1cbe2e****",
                    "Width" : 200,
                    "Height" : 100,
                    "X" : 100,
                    "Y" : 100
                }
            ]
        }
    ]
}

Configurer l'incrustation d'image (picture-in-picture)

{
    "VideoTracks":[
        {
            "VideoTrackClips":[
                {
                    "MediaId":"756620ed48c9af022c66ee1cbe2e****",
                    "Type":"Video"
                }
            ]
        },
        {
            "VideoTrackClips":[
                {
                    "Effects":[
                        {
                            "Type":"Scale",
                            "TimelineIn":0,
                            "TimelineOut":100,
                            "Width":0.3,
                            "Height":0.4
                        }
                    ],
                    "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
                    "Type":"Video",
                    "Duration":100,
                    "X":0.5,
                    "Y":0
                }
            ]
        }
    ]
}

Combiner plusieurs vidéos et ajouter des effets de transition ainsi qu'une musique de fond

{
    "VideoTracks":[
        {
            "VideoTrackClips":[
                {
                    "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
                    "Effects":[
                        {
                            "Type":"Transition",
                            "SubType":"directional",
                            "Duration":2
                        }
                    ]
                },
                {
                    "MediaId":"756620ed48c9af022c66ee1cbe2e****",
                    "Effects":[
                        {
                            "Type":"Transition",
                            "SubType":"waterdrop",
                            "Duration":1
                        }
                    ]
                },
                {
                    "MediaId":"8f5cdf044b059b3adc7967ba1cbe****"
                }
            ]
        }
    ],
    "AudioTracks":[
        {
            "AudioTrackClips":[
                {
                    "MediaId":"756620ed48c9af022c66ee1cbe2e****"
                }
            ]
        }
    ]
}

Ajouter deux fichiers audio à un album photo et configurer leur lecture simultanée

{
    "VideoTracks":[
        {
            "VideoTrackClips":[
                {
                    "Type":"Image",
                    "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
                    "Duration":10
                },
                {
                    "Type":"Image",
                    "MediaId":"756620ed48c9af022c66ee1cbe2e****",
                    "Duration":10
                },
                {
                    "Type":"Image",
                    "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
                    "Duration":10
                },
                {
                    "Type":"Image",
                    "MediaId":"756620ed48c9af022c66ee1cbe2e****",
                    "Duration":10
                }
            ]
        }
    ],
    "AudioTracks":[
        {
            "AudioTrackClips":[
                {
                    "MediaId":"8f5cdf044b059b3adc7967ba1cbe****"
                }
            ]
        },
        {
            "AudioTrackClips":[
                {
                    "MediaId":"756620ed48c9af022c66ee1cbe2e****",
                   
                }
            ]
        }
    ]
}

Configurer la lecture en boucle de l'audio

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId":"756620ed48c9af022c66ee1cbe2e****",
                }
            ]
        }
    ],
    "AudioTracks": [
        {
            "AudioTrackClips": [
                {
                    "MediaId":"756620ed48c9af022c66ee1cbe2e****",
                    "LoopMode": true,
                    "In": 42,
                    "Out": 58,
                    "TimelineIn": 5,
                    "TimelineOut": 30,
                    "Comment": "Play the audio from the 42nd to 58th second in a loop from the 5th to 30th second in the timeline."
                }
            ]
        }
    ]
}

Supprimer les bandes noires

L'exemple suivant montre comment retirer les bandes noires situées en haut et en bas d'une vidéo 1920 × 1080, puis ajouter des sous-titres. La hauteur des bandes noires est de 130 pixels.

{
    "VideoTracks":[
        {
            "VideoTrackClips":[
                {
                    "MediaId":"756620ed48c9af022c66ee1cbe2e****",
                    "X":0,
                    "Y":0,
                    "Effects":[
                        {
                            "Type":"Crop",
                            "X":0,
                            "Width":1920,
                            "Height":820,
                            "Y":130
                        }
                    ]
                }
            ]
        }
    ],
    "SubtitleTracks":[
        {
            "SubtitleTrackClips":[
                {
                    "Type":"Subtitle",
                    "SubType":"srt",
                    "FileURL":"https://your-bucket.oss-cn-shanghai.aliyuncs.com/object.srt"
                }
            ]
        }
    ]
}
Important

L'exemple suivant illustre la configuration de

OutputConfig

pour définir la taille de la vidéo de sortie.

{
    "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
    "Width":1920,
    "Height":820
}

Utiliser des autocollants GIF

Pour utiliser des autocollants GIF, configurez DyncFrames afin de spécifier la fréquence d'images des autocollants.

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "MediaId":"8f5cdf044b059b3adc7967ba1cbe****"
        }]
    }, {
        "VideoTrackClips": [{
            "MediaId":"756620ed48c9af022c66ee1cbe2e****",
            "Type": "Image",
            "DyncFrames": 8,
            "TimelIneIn": 0.0,
            "TimelIneOut": 50.0,
            "X": 50,
            "Y": 50,
            "Effects": [{
                "Type": "Scale",
                "Height": 100,
                "Width": 100
            }]
    }]
}

Utiliser des filtres de rendu

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "TimelineIn": 0,
      "Type": "Video",
      "Out": 10,
      "MediaId": "MediaId1",
      "Effects": [{
        "SubType": "color",
        "ExtParams": "effect=color,brightness=80,contrast=0,saturation=0,kelvin_temperature=6000,temperature_ratio=0,tint=0,dark_corner_ratio=0",
        "Type": "Filter",
        "TimelineIn": 0,
        "TimelineOut": 10
      }]
    }]
  }]
}

Configurer les variations de vitesse (speed ramping)

Pour modifier la vitesse de lecture d'un clip, configurez la propriété Speed. Le speed ramping affecte la durée du clip. Par exemple, si Out est défini sur 10 secondes et Speed sur 2 pour un clip, la durée du clip dans la timeline sera de 5 secondes. Dans ce cas, définissez TimelineOut sur 5. Si TimelineIn et TimelineOut restent vides, la position du clip dans la timeline est calculée automatiquement lors de la production, en fonction des valeurs de In, Out et Speed.

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
      "Speed": 2,
      "Out": 10,
      "TimelineIn": 0,
      "TimelineOut": 5
    }, {
      "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
      "Speed": 0.5,
      "In": 10,
      "Out": 20
    }]
  }],
  "AudioTracks": [{
    "AudioTrackClips": [{
      "MediaId":"756620ed48c9af022c66ee1cbe2e****",
      "Speed": 2
    }]
  }]
}

Configurer la rotation des éléments multimédias

Pour faire pivoter un élément multimédia, définissez "Type": "Rotate". Vous pouvez appliquer une rotation de 90, 180 ou 270 degrés.

  • Faire pivoter un élément dans une piste vidéo

    {
      "VideoTracks": [
        {
          "VideoTrackClips": [
            {
              "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
              "In": 0,
              "Out": 5,
              "Effects": [
                {
                  "Type": "Rotate",
                  "Degree": 90
                }
              ]
            }
          ]
        }
      ]
    }
  • Faire pivoter un élément dans une piste image

    {
      "VideoTracks": [
        {
          "VideoTrackClips": [
            {
              "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
              "In": 0,
              "Out": 15
            }
          ]
        }
      ],
      "ImageTracks": [
        {
          "ImageTrackClips": [
            {
              "ImageId": "70dc95c0e31b71edbfe76fa3691c****",
              "Width": 0.9,
              "Height": 0.9,
              "X": 0.15,
              "Y": 0.15,
              "Effects": [
                {
                  "Type": "Rotate",
                  "Degree": 90
                }
              ]
            }
          ]
        }
      ]
    }

Ajouter des images sur l'intégralité de la vidéo

Pour ajouter des images sur toute la durée de la vidéo, spécifiez GlobalImage. Aucune durée n'est requise : les images s'affichent pendant la durée totale de toutes les pistes vidéo fusionnées. Cette fonctionnalité permet de configurer un arrière-plan global ou un filigrane global.

  • Configurer un filigrane global

    {
        "VideoTracks": [
            {
                "VideoTrackClips": [
                    {
                        "MediaId":"8f5cdf044b059b3adc7967ba1cbe****"
                    }
                ]
            },
            {
                "VideoTrackClips": [
                    {
                        "MediaId":"756620ed48c9af022c66ee1cbe2e****",
                        "Type": "GlobalImage",
                        "X": 0.1,
                        "Y": 0.1,
                        "Width": 247,
                        "Height": 74
                    }
                ]
            }
        ]
    }
  • Configurer un arrière-plan global

    {
        "VideoTracks": [
            {
                "VideoTrackClips": [
                    {
                        "MediaId":"756620ed48c9af022c66ee1cbe2e****",
                        "Type": "GlobalImage"
                    }
                ]
            },
            {
                "VideoTrackClips": [
                    {
                        "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
                        "Effects": [
                            {
                                "Type": "Volume",
                                "Gain": 0
                            }
                        ]
                    }
                ]
            }
        ]
    }

Configurer MaxOut pour une piste vidéo

Pour découper un segment vidéo à partir d'une piste vidéo, configurez MaxOut. Les règles suivantes s'appliquent lors du découpage d'une vidéo :

  • Si la valeur de MaxOut est inférieure à la durée du média d'origine, MaxOut indique le moment où le média est coupé à partir du matériau d'origine.

  • Si la valeur de MaxOut est supérieure à la durée du média d'origine, le média est coupé à partir de la fin du matériau d'origine.

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
            {
                "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
                "MaxOut": 10
            },{
                "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
                "Effects": [{
                "Type": "Scale",
                "Width": 0.8,
                "Height": 0.8
            }]
        }]
    }]
}
Remarque
  • Si vous configurez Out pour découper un segment vidéo et que la valeur de Out est supérieure à la durée du média d'origine, des images statiques apparaissent.

  • Si vous configurez MaxOut et Out, Out prend effet et MaxOut devient invalide.

Utiliser un effet aléatoire

ApsaraVideo VOD prend en charge les effets aléatoires. Vous pouvez intégrer dans une timeline un clip aléatoire, un filtre aléatoire, un effet spécial aléatoire et un effet de transition aléatoire.

  • Clip aléatoire : sélectionne aléatoirement un clip d'une durée spécifiée à partir du média d'origine et l'ajoute à la timeline.

  • Filtre aléatoire : choisit aléatoirement un filtre parmi une plage définie ou parmi l'ensemble des filtres disponibles.

  • Effet spécial aléatoire : sélectionne aléatoirement un effet spécial parmi une plage définie ou parmi tous les effets spéciaux.

  • Effet de transition aléatoire : choisit aléatoirement un effet de transition parmi une plage définie ou parmi l'ensemble des effets de transition.

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "8f5cdf044b059b3adc7967ba1cbe****",
                    "TimelineIn": 0,
                    "Effects": [
                        {
                            "Comment": "Randomly select a transition effect from all transition effects",
                            "Type": "Transition",
                            "SubType": "random",
                            "Duration": 1
                        },
                        {
                            "Comment": "Randomly cut a clip of 5 seconds from the material.",
                            "Type": "Clip",
                            "SubType": "RandomClip",
                            "ClipDuration": 5
                        }
                    ]
                },
                {
                    "MediaId": "8f5cdf044b059b3adc7967ba1cbe****",
                    "TimelineIn": 5,
                    "Effects": [
                        {
                            "Comment": "Randomly select a special effect among open, zoom, and disappear.",
                            "Type": "VFX",
                            "SubType": "open,zoom,disappear"
                        }
                    ]
                },
                {
                    "MediaId": "8f5cdf044b059b3adc7967ba1cbe****",
                    "TimelineIn": 10,
                    "Effects": [
                        {
                            "Comment": "Randomly select a filter among pl4, colorfulstarry, and flyfire.",
                            "Type": "Filter",
                            "SubType": "pl4,colorfulstarry,flyfire"
                        }
                    ]
                }
            ]
        }
    ]
}

Création de sous-titres

Configurer les sauts de ligne et l'alignement

Pour gérer les sauts de ligne, ajoutez \n ou \\n dans le texte du sous-titre. Pour définir l'alignement du texte, spécifiez Alignment.

{
  "VideoTracks": [
    {
      "VideoTrackClips": [
        {
          "MediaId": "8f5cdf044b059b3adc7967ba1cbe****",
          "Effects": [
            {
              "Type": "Text",
              "X": 20,
              "Y": 34,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "Add \n to configure a line breaking and set Alignment to TopCenter to center the subtitle text in each line.",
              "Alignment": "TopCenter",
              "FontSize": 26,
              "FontColorOpacity": 1,
              "FontColor": "#ff0000",
              "FontFace": {
                "Bold": true,
                "Italic": false,
                "Underline": false
              }
            },
            {
              "Type": "Text",
              "X": 100,
              "Y": 200,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "Add \n to configure a line breaking and set Alignment to TopLeft to align the subtitle text to the left.",
              "Alignment": "TopLeft",
              "FontSize": 26,
              "FontColorOpacity": 0.8,
              "FontColor": "#ff0000"
            },
            {
              "Type": "Text",
              "X": 0.10,
              "Y": 0.1,
              "TimelineIn": 2,
              "TimelineOut": 15,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "Add \n to configure a line breaking and set Alignment to TopRight to align the subtitle text to the right.",
              "Alignment": "TopRight",
              "FontSize": 26,
              "FontColor": "#000000"
            }
          ]
        }
      ]
    }
  ]
}

Configurer des effets spéciaux et des effets de style artistique pour le texte

Pour appliquer un effet de style artistique, spécifiez EffectColorStyle ainsi que l'épaisseur du contour et la couleur de l'ombre. Pour davantage d'exemples, consultez Exemples d'effets de style artistique.

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaId": "756620ed48c9af022c66ee1cbe2e****",
      "Effects": [{
        "Type": "Text",
        "X": 33,
        "Y": 34,
        "Font": "WenQuanYi Zen Hei Mono",
        "Content": "Word art: brushed_aluminium, entrance effect: rotateflip_in, exit effect: slide_down_out",
        "OutlineColour": "#4effcf",
        "BackColour": "#2effc6",
        "Outline": 2,
        "Shadow": 2,
        "EffectColorStyle": "brushed_aluminium",
        "FontSize": 42,
        "AaiMotionInEffect": "rotateflip_in",
        "AaiMotionIn": 1,
        "AaiMotionOutEffect": "slide_down_out",
        "AaiMotionOut": 1,
        "FontFace": {
          "Bold": true,
          "Italic": false,
          "Underline": false
        }
      },
        {
          "Type": "Text",
          "X": 66,
          "Y": 256,
          "Font": "WenQuanYi Zen Hei Mono",
          "Content": "Word art: deep_sea, loop effect: rainbrush_display, quick loop",
          "EffectColorStyle": "deep_sea",
          "OutlineColour": "#e9e9e9",
          "BackColour": "#30335c",
          "Outline": 2,
          "Shadow": 2,
          "AaiMotionLoopEffect": "rainbrush_display",
          "Ratio": 2,
          "FontSize": 38,
          "FontColorOpacity": 0.8,
          "FontColor": "#d60e0e"
        }
      ]
    }]
  }]
}
Remarque

Un effet en boucle ne fonctionne pas conjointement avec un effet d'entrée ou de sortie pour un texte. Si vous configurez à la fois un effet en boucle et un effet d'entrée ou de sortie, seuls les effets d'entrée et de sortie sont appliqués.

Utiliser un fichier de sous-titres lors du montage vidéo

{
  "VideoTracks": [
    {
      "VideoTrackClips": [
        {
          "MediaId": "756620ed48c9af022c66ee1cbe2e****"
        },
        {
          "MediaId": "8f5cdf044b059b3adc7967ba1cbe****"
        }
      ]
    }
  ],
  "SubtitleTracks": [
    {
      "SubtitleTrackClips": [
        {
          "Type": "Subtitle",
          "SubType": "srt",
          "FileUrl": "http://your-bucket.oss-cn-shanghai.aliyuncs.com/your-subtitle.srt"
        }
      ]
    }
  ]
}

Configurer un arrière-plan pour le texte

Pour ajouter un arrière-plan au texte, spécifiez "BorderStyle": 3, la largeur de l'arrière-plan via Outline et sa couleur avec OutlineColour.

{
 "VideoTracks": [{
  "VideoTrackClips": [{
   "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
   "Effects": [{
    "Type": "Text",
    "X": 33,
    "Y": 34,
    "Content": "Configure a text background.",
    "FontSize": 42,
    "BorderStyle": 3,
    "FontColor": "#4B0082",
    "Outline": 3,
    "OutlineColour": "#FFDEAD"
   }]
  }]
 }]
}

Album photo

Créer un album photo sans sous-titres

Générez une vidéo à partir d'un diaporama d'images en configurant l'ordre des photos et la propriété Duration.

{
  "VideoTracks": [
      {
          "VideoTrackClips": [
              {
                "Type": "image",
                "MediaId": "756620ed48c9af022c66ee1cbe2e****",
                "Duration": 3
              },
              {
                "Type": "image",
                "MediaId": "8f5cdf044b059b3adc7967ba1cbe****",
                "Duration": 3
              },
              {
                "Type": "image",
                "MediaId": "70dc95c0e31b71edbfe76fa3691c****",
                "Duration": 3
              }
          ]
      }
  ]
}

Créer un album photo avec sous-titres

Réalisez une vidéo à partir d'un diaporama en indiquant la séquence d'images et la propriété Duration. Configurez Effects pour définir le format du texte des sous-titres.

{
    "VideoTracks": [{
      "VideoTrackClips": [{
        "Type": "image",
        "MediaId": "756620ed48c9af022c66ee1cbe2e****",
        "Effects": [
          {
            "Type": "Text",
            "X": 33,
            "Y": 34,
            "Font": "WenQuanYi Zen Hei Mono",
            "Content": "Test text",
            "FontSize": 26,
            "FontColorOpacity": 1,
            "FontColor": "#000000",
            "FontFace": {
              "Bold": true,
              "Italic": false,
              "Underline": false
            }
          }
        ],
          "Duration": 5
      }, {
        "Type": "image",
        "MediaId": "8f5cdf044b059b3adc7967ba1cbe****",
        "Duration": 5
      }, {
        "Type": "image",
        "MediaId": "70dc95c0e31b71edbfe76fa3691c****",
        "Effects": [
          {
            "Type": "Text",
            "X": 0.7123,
            "Y": 0.7896,
            "TimelineIn": 11,
            "TimelineOut": 13,
            "Font": "WenQuanYi Zen Hei Mono",
            "Content": "Test text",
            "FontSize": 26,
            "FontColor": "#000000"
          }
        ],
        "Duration": 5
      }]
    }]
  }