Clip Ranges
video-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 pairs. Each pair defines a segment to include in the output, and segments are joined in the order specified. Boundary values can be expressed in seconds or as a percentage of the video’s total duration.
| Format | Example value | Behavior |
|---|---|---|
| Seconds | 0-5;10-15;18-22 | Three segments at 0–5s, 10–15s, and 18–22s |
| Percentage | 0-25%25;50%25-75%25 | Two segments covering 0%–25% and 50%–75% of the total duration |
| Mixed | 0-25%25 | Start at 0s, end at 25% of the total duration |
Encoding the % character
Percentage values use a % suffix, which 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. Seconds and percentages can be mixed within the same range pair or across pairs.
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.