Upload and host a video
Upload a video, let PB Play encode it into an adaptive ladder, and play it from your page with one snippet.
In the dashboard
Open Media and choose Upload video. The file goes from your browser straight to storage — never through the control plane — and large files are sent in parts, so a dropped connection resumes rather than starts again. The item exists from the first second: its page is linkable while the bytes are still arriving. Once they land, the media service encodes an HLS ladder, takes a poster and a storyboard, and the item becomes ready. The dashboard tells you when the encode finishes or fails; so can a webhook (media.encoded, media.encode_failed), and both appear in the property's Logs.
Hosted files are served from signed links that expire, so a copied URL stops working. A georestriction rule attached to the item is signed into those links and enforced at the edge.
With the API
Register the item, open an upload, send the parts to the URLs it returns, then complete it.
- mediaRegisterCreate the item: a title, and no source yet.
- mediaOpenUploadOpen an upload for the file: its size and type. Answers signed part URLs.
- mediaUploadPartsThe parts already stored, to resume an interrupted upload.
- mediaCompleteUploadFinish it. The encode starts.
- mediaProgressHow far along the encode is.
- mediaGetThe item, with its status: incomplete, ready or failed.
- mediaPlaybackThe playback object a player is given, with signed URLs.
- mediaBulkRemove, set a geo rule on, or add to a playlist many items in one request.
On your page
A page plays hosted media through a playlist: add the item to one (Playlists, or mediaBulk with add-to-playlist) and embed the playlist. Its public feed carries each item's playback object with freshly signed links, and the player refetches it before they expire.
<div id="pb-player"></div>
<script
src="https://cdn.stream.tulip-tech.app/sdk/web/index"
data-key="pbp_live_…"
data-playlist="ply_…"
data-target="pb-player"></script>