Documentation

Getting Started

1. Create an Account

Sign up for a free account to get started with 5GB storage and 20GB bandwidth.

2. Upload Your Video

Use the dashboard upload feature or our API to upload videos. We support MP4, WebM, MOV, MKV, and AVI formats. Large files are automatically chunked for reliable uploads.

3. Share or Embed

Get embed codes, direct stream URLs, or HLS manifest URLs from the Embed section of your dashboard.

API Reference

GET/api/videos

List all your videos. Supports pagination, search, and status filtering.

POST/api/videos

Create a new video record. Returns video ID for upload.

POST/api/videos/upload/init

Initialize a chunked upload session. Returns upload ID and chunk configuration.

POST/api/videos/upload/chunk

Upload a single chunk. Send as multipart form with uploadId, chunkIndex, and chunk data.

POST/api/videos/upload/complete

Complete a chunked upload. Merges chunks and starts processing.

GET/api/videos/stream/:id

Stream a video with range request support for seeking.

Video Streaming

StreamVault streams videos using a Hono worker running on Cloudflare Workers, pulling directly from R2 storage. Videos are served with:

  • Range request support - Efficient seeking without downloading the full file
  • HLS adaptive streaming - Automatic quality adaptation based on connection speed
  • Edge caching - Responses cached at Cloudflare's 150+ edge locations
  • Zero egress fees - Cloudflare R2 has no egress charges

Embed Player

Embed StreamVault's player on any website with a simple iframe:

<iframe
  src="https://worker.your-domain.com/embed/VIDEO_ID"
  width="100%"
  style="aspect-ratio: 16/9;"
  frameborder="0"
  allow="autoplay; fullscreen"
  allowfullscreen
></iframe>