Highlight clipping

To generate a highlight clip using the Studio API, follow these steps:

1. Determine your playlist URL

If you are using Motto for your live-streams and VODs, then this is the public_url on the playlist (and the playlist ID can be retrieved from the video. Alternatively, you can find it in the Video Manager:

If you are using an external source, this can be any valid and accessible HLS playlist.

2. Create a clip

Call the create clip endpoint with your playlist URL from step 1.

3. Retrieve the asset

With the reserved_asset_id in the response from the previous step, you can retrieve the asset for the clip once the clip reaches STATE_READY. This may take a bit of time, depending on the length and complexity of the clip.

Generating a highlight clip via the Studio’s Video Manager is an indirect operation. Rather than indicating which exact parameters should be used for creating a clip, you simply annotate (or: tag) your video by indicating what happens at certain points in your video, and let the system figure out what kind of clip should be generated based on this information.

For example, if you indicate that a “Goal” just happened, the system may be pre-configured to generate a clip that starts 20 seconds before the goal and ends 20 seconds after the goal.

This approach is generally recommended, as these video tags can be used in other contexts as well (e.g. to draw a goal inlay in your stream, or trigger a webhook call to your OTT website/app to update the UI accordingly).

How to annotate

1. Go to the Video Manager and select the video you want to annotate.
2. Switch to the “Video tagging” tab.
3. Click any of the tag buttons to add a tag to the video at the current time of the video player. The kinds of tags that are available are fully configurable; they are not bound to the kinds shown below. Please reach out for help with setting up different kinds of tags.