Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Exemplos de configuração de Timeline

Última atualização: Jun 27, 2026

Ao enviar um job de produção com dados de timeline, configure o parâmetro Timeline. Este tópico apresenta exemplos de configuração de Timeline para edição de vídeo, criação de legendas e álbuns de fotos.

Descrição

Para obter mais informações sobre os parâmetros nos exemplos a seguir, consulte Timeline: informações sobre a timeline de um projeto de edição online.

Edição de vídeo

Adicionar uma legenda centralizada

Para adicionar uma legenda centralizada na parte superior de um vídeo, especifique "Alignment": "TopCenter" e defina Y como a distância entre o texto da legenda e a parte superior da tela.

{
  "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"
            }
          ]
        }
      ]
    }
  ]
}
Nota
  • Valores válidos para Alignment: BottomLeft, BottomCenter, BottomRight, CenterLeft, CenterCenter, CenterRight, TopLeft, TopCenter e TopRight.

  • Se Alignment estiver incluído no parâmetro Effects, X indica a distância entre o texto da legenda e o lado esquerdo da tela, enquanto Y indica a distância entre o texto da legenda e a parte superior da tela.

Adicionar uma marca d'água e especificar localização, hora de início e hora de término

{
    "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
                }
            ]
        }
    ]
}

Adicionar uma marca d'água sem especificar a duração

Use ImageTracks para configurar uma marca d'água sem especificar uma duração. A marca d'água será exibida durante todo o vídeo.

{
    "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
                }
            ]
        }
    ]
}

Configurar 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
                }
            ]
        }
    ]
}

Combinar vários vídeos e adicionar efeitos de transição e música de fundo

{
    "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****"
                }
            ]
        }
    ]
}

Adicionar dois arquivos de áudio a um álbum de fotos e configurá-los para reprodução simultânea

{
    "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****",
                   
                }
            ]
        }
    ]
}

Configurar reprodução em loop de áudio

{
    "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."
                }
            ]
        }
    ]
}

Remover barras pretas

O exemplo a seguir mostra como remover as barras pretas da parte superior e inferior de um vídeo de 1920 × 1080 e adicionar legendas. A altura das barras pretas é 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"
                }
            ]
        }
    ]
}
Importante

O exemplo a seguir mostra como configurar

OutputConfig

para especificar o tamanho do vídeo de saída.

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

Usar adesivos GIF

Para usar adesivos GIF, configure DyncFrames para especificar a taxa de quadros dos adesivos.

{
    "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
            }]
    }]
}

Usar filtros de renderização

{
  "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
      }]
    }]
  }]
}

Configurar variação de velocidade

Para alterar a velocidade de reprodução de um clipe, configure a propriedade Speed. A variação de velocidade altera a duração do clipe. Por exemplo, se Out for definido como 10 segundos e Speed for definido como 2 para um clipe, a duração do clipe na timeline será de 5 segundos. Nesse caso, defina TimelineOut como 5. Se TimelineIn e TimelineOut forem deixados vazios, a posição do clipe na timeline será calculada automaticamente durante a produção com base nos valores de In, Out e 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
    }]
  }]
}

Configurar rotação de material

Para girar o material, defina "Type": "Rotate". É possível girar materiais em 90, 180 e 270 graus.

  • Girar um material em uma faixa de vídeo

    {
      "VideoTracks": [
        {
          "VideoTrackClips": [
            {
              "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
              "In": 0,
              "Out": 5,
              "Effects": [
                {
                  "Type": "Rotate",
                  "Degree": 90
                }
              ]
            }
          ]
        }
      ]
    }
  • Girar um material em uma faixa de imagem

    {
      "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
                }
              ]
            }
          ]
        }
      ]
    }

Adicionar imagens a todo o vídeo

Para adicionar imagens a todo o vídeo, especifique GlobalImage. Não é necessário especificar a duração. As imagens são exibidas durante a duração total de todas as faixas de vídeo mescladas. Use este recurso para configurar um fundo global ou uma marca d'água global.

  • Configurar uma marca d'água global

    {
        "VideoTracks": [
            {
                "VideoTrackClips": [
                    {
                        "MediaId":"8f5cdf044b059b3adc7967ba1cbe****"
                    }
                ]
            },
            {
                "VideoTrackClips": [
                    {
                        "MediaId":"756620ed48c9af022c66ee1cbe2e****",
                        "Type": "GlobalImage",
                        "X": 0.1,
                        "Y": 0.1,
                        "Width": 247,
                        "Height": 74
                    }
                ]
            }
        ]
    }
  • Configurar um fundo global

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

Configurar MaxOut para uma faixa de vídeo

Para recortar um segmento de vídeo de uma faixa de vídeo, configure MaxOut. As seguintes regras se aplicam ao recortar um vídeo:

  • Se o valor de MaxOut for menor que a duração do material original, MaxOut indica o momento em que o material é cortado a partir do material original.

  • Caso o valor de MaxOut seja maior que a duração do material original, o corte ocorre a partir do final do material original.

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
            {
                "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
                "MaxOut": 10
            },{
                "MediaId":"8f5cdf044b059b3adc7967ba1cbe****",
                "Effects": [{
                "Type": "Scale",
                "Width": 0.8,
                "Height": 0.8
            }]
        }]
    }]
}
Nota
  • Se você configurar Out para recortar um segmento de vídeo e o valor de Out for maior que a duração do material original, imagens estáticas aparecerão.

  • Ao configurar tanto MaxOut quanto Out, apenas Out terá efeito e MaxOut será ignorado.

Usar um efeito aleatório

O ApsaraVideo VOD oferece suporte a efeitos aleatórios. É possível usar clipes, filtros, efeitos especiais e efeitos de transição aleatórios em uma timeline.

  • Clipe aleatório: seleciona aleatoriamente um clipe de duração especificada do material original e o adiciona à timeline.

  • Filtro aleatório: seleciona aleatoriamente um filtro de um intervalo especificado ou de todos os filtros disponíveis.

  • Efeito especial aleatório: escolhe aleatoriamente um efeito especial de um intervalo especificado ou de todos os efeitos especiais.

  • Efeito de transição aleatório: seleciona aleatoriamente um efeito de transição de um intervalo especificado ou de todos os efeitos de transição.

{
    "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"
                        }
                    ]
                }
            ]
        }
    ]
}

Produção de legendas

Configurar quebra de linha e alinhamento

Para configurar a quebra de linha, adicione \n ou \\n no texto da legenda. Para configurar o alinhamento do texto da legenda, especifique 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"
            }
          ]
        }
      ]
    }
  ]
}

Configurar efeitos especiais e efeitos de word art para texto

Para configurar um efeito de word art, especifique EffectColorStyle, além da largura do contorno e da cor da sombra. Para mais exemplos de word art, consulte Exemplos de efeitos de word art.

{
  "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"
        }
      ]
    }]
  }]
}
Nota

Um efeito de loop não funciona em conjunto com um efeito de entrada ou saída para um texto. Se você configurar um efeito de loop e um efeito de entrada ou saída para um texto, apenas os efeitos de entrada e saída terão efeito.

Usar um arquivo de legenda na edição de vídeo

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

Configurar um fundo de texto

Para configurar um fundo de texto, especifique "BorderStyle": 3, a largura do fundo Outline e a cor do fundo 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"
   }]
  }]
 }]
}

Álbum de fotos

Criar um álbum de fotos sem legendas

Crie um vídeo a partir de uma apresentação de slides configurando a sequência de imagens e Duration.

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

Criar um álbum de fotos com legendas

Gere um vídeo a partir de uma apresentação de slides configurando a sequência de imagens e Duration. Configure Effects para especificar o formato do texto da legenda.

{
    "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
      }]
    }]
  }