Skip to content

Share a clip without processing another video

On ready content, open Share & embed → Share a clip. Enter start and end times in the original and select Apply clip. The dashboard shows actual boundaries and the resulting duration. The player’s start time is expressed within the clip.

Instant clipping selects existing HLS segments; it does not create another asset, HLS objects, or an encoding job. The start aligns to the preceding segment and the end to the following one. For a precise cut, create a clip as a standalone asset.

Times must be finite, between 0 and 7,200 seconds, with the end greater than the start. An end beyond the duration is clamped to the content; a start outside it is rejected. Subtitles, chapters, and storyboards adapt to the window. Auxiliary tracks must align; Orilla rejects a presentation that would be out of sync.

Readers can generate temporary access; publishing or revoking requires write permission. Editing boundaries or access hides the previous link until you apply again. Renewing temporary access preserves the selected window.

With the server client and a public playback ID:

const clip = { assetStartTime: 6.2, assetEndTime: 11.9 };
const hls = orilla.media.hlsURL(playbackId, undefined, clip);
const iframe = orilla.media.embedURL(playbackId, undefined, clip);
const storyboard = orilla.media.storyboardURL(playbackId, undefined, clip);

For a signed playback ID, store boundaries in the JWT and use the same options for playback and storyboard:

import { signPlaybackToken } from "@orilla-video/sdk";
const playbackToken = await signPlaybackToken(playbackId, signingKey, {
expiresIn: 300,
playbackModifiers: clip,
});
const storyboardToken = await signPlaybackToken(playbackId, signingKey, {
expiresIn: 300,
audience: "s",
playbackModifiers: clip,
});
const signedHLS = orilla.media.hlsURL(playbackId, playbackToken);
const signedStoryboard = orilla.media.storyboardURL(
playbackId,
storyboardToken,
);

playbackId and signingKey are resources already created in your environment. Do not combine a token with the third modifiers argument. Restricted tokens reject segments outside the window and full MP4/M4A downloads. Authorized thumbnails must fall inside the clip; thumbnail/GIF audiences do not accept these claims.

The native POST /v1/assets/:id/playback API accepts optional numeric asset_start_time and asset_end_time and returns the canonical window and temporary access. See the reference and access rules.