Loop Style

We provide 3 ways to adjust how a video loops in a scene.

loop
fit_to_scene
freeze

Let's see how these three loop styles affect video rendering.

Loop

Loop, literally, will make the video loop until the end of the video track.

Fit to scene

This will speed up or slow down the video to make sure the video duration is exactly the same as the scene duration.

Freeze

After the video has finished playing, continue to maintain the last frame of the video, until the end of the video track.

Example

Here is an example of adjusting the loop style of a video.

Template video:
c2735a01d43343babb9138528a68cd46

Get variables:

{
  "code": 100,
  "data": {
    "scenes": [
      {
        "variables": [
          {
            "name": "video_0",
            "properties": [
              {
                "default": "https://files.movio.la/prod/movio/preset/video/origin/d9831b49b2ed4f5a8cad812f66bf4cb9.mp4?Expires=1690694996&Signature=OzcLOuIZZ5lQ-Fv3HI5SoOwxyIZpiTw7fIH5zuwOv636CtsjvIJMz~edLVtkbCGeyCHuQOyKTpJdzPXAoqg1BZgzqtUzmfoQL2lpnqbR8HruHZXf1C~NHeAUQEvDdIUP2U7G6xAOHFEMwsH2sfbbfAbiG0X9omAErmVU9rNSgJwy6I4XSROHQlsuhoZ7bIRwu5knA3OuFY1y9s3RI9sthi1Ia5mc1rQ~QVsDmbCWLtkEnRFSjqoYj762gQe2W3ZOml04oiB1riXBmtsUcidzztReOH9XBdjoQzj7R5H9S3rkaZxXsJdNwNekG4K-SipFqdJAFH7enUhEydTxPFx1GA__&Key-Pair-Id=K49TZTO9GZI6K",
                "name": "link"
              },
              {
                "default": "none",
                "name": "play_style"
              }
            ],
            "type": "video"
          }
        ]
      }
    ],
    "template_id": "c2735a01d43343babb9138528a68cd46",
    "video_id": "c2735a01d43343babb9138528a68cd46"
  },
  "message": "Success"
}

Generate video from template:

curl --location --request POST 'https://api.heygen.com/v1/template.generate' \                                             rui/api_quota
--header 'x-api-key: <your api key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "template_id": "c2735a01d43343babb9138528a68cd46",
    "title": "test sub video",
    "test":true,
    "variables": [
         {
               "properties": {
                    "play_style": "fit"
               },
               "name": "video_0"
          }
    ]
}'