Clip Ranges

Selects and concatenates multiple non-contiguous segments from a video in a single request.

video-clip-ranges accepts a semicolon-separated list of start-end time pairs in seconds. Each pair defines a segment to include in the output, and the segments are joined in the order they are specified.

video-clip-ranges=0-5;10-15;18-22

The example above produces a single output video containing three segments: seconds 0–5, seconds 10–15, and seconds 18–22, concatenated in that order.

Comparison with individual clip parameters

The video-clip-start, video-clip-end, and video-clip-duration parameters extract a single contiguous segment. Use video-clip-ranges when you need to extract and join multiple non-contiguous segments in one operation.

video-clip-ranges cannot be combined with video-clip-start, video-clip-end, or video-clip-duration.

Percentage Offsets

Range boundary values also accept a percentage of the video’s total duration. Append a % suffix to any boundary value.

Because % is a reserved character in URLs, it must be percent-encoded as %25 in query strings. A value of 25% is written as 25%25 in the URL.

video-clip-ranges=0-25%25;50%25-75%25

Seconds and percentages can be mixed within the same range pair or across range pairs. For example, 0-25%25 starts at 0 seconds and ends at 25% of the total duration.

https://assets.imgix.net/videos/girl-reading-book-in-library.mp4?fm=mp4&video-clip-ranges=0-25%25;50%25-75%25