Stream Video Demo

Create Cloudflare Stream direct upload URLs and signed playback tokens from a Worker via the Stream binding. Locally (or without a live binding) endpoints return demo values with mode: "demo".

FeaturesCopy Anchor Link

• Direct creator upload URL via env.STREAM.createDirectUpload
• Signed playback token via env.STREAM.video(uid).generateToken
• Demo mode when the Stream binding is unavailable

API ReferenceCopy Anchor Link

POST /upload-urlCopy Anchor Link

Create a one-time direct upload URL.

Body (optional JSON)

Example RequestCopy Anchor Link

curl -X POST "https://your-worker.workers.dev/upload-url" \
  -H "Content-Type: application/json" \
  -d '{"maxDurationSeconds": 600}'

Success ResponseCopy Anchor Link

{
  "uploadURL": "https://upload.cloudflarestream.com/...",
  "uid": "video-uid",
  "mode": "live",
  "maxDurationSeconds": 600
}

Error CodesCopy Anchor Link

• 400 - Invalid JSON / duration (INVALID_BODY)
• 502 - Stream API failure (STREAM_ERROR)

GET /playback-tokenCopy Anchor Link

Generate a signed playback token for a video UID.

uid string (required)

Stream video UID.

Example RequestCopy Anchor Link

curl "https://your-worker.workers.dev/playback-token?uid=VIDEO_UID"

Success ResponseCopy Anchor Link

{
  "token": "signed-playback-token",
  "uid": "VIDEO_UID",
  "playbackUrl": "https://videodelivery.net/signed-playback-token/manifest/video.m3u8",
  "mode": "live"
}

Error CodesCopy Anchor Link

• 400 - Missing uid (INVALID_UID)
• 502 - Stream API failure (STREAM_ERROR)

Use CasesCopy Anchor Link

• Let end users upload video without exposing Stream API tokens
• Issue short-lived playback tokens for private videos
• Prototype creator-upload + secure viewing flows on Workers

LimitationsCopy Anchor Link

• Requires Stream enabled on the account for live mode
• Basic POST uploads are limited to ~200 MB (use tus via REST for larger files)
• Demo mode returns placeholder URLs/tokens

DeploymentCopy Anchor Link

curl -X POST "https://your-worker.workers.dev/upload-url"

Local DevelopmentCopy Anchor Link

cd apps/experiments/stream-video-demo
npm install
npm run dev

Without a live Stream binding, responses include "mode": "demo".

ConfigurationCopy Anchor Link

wrangler.json declares:

• Stream binding STREAM

Cloudflare Features UsedCopy Anchor Link

• Workers - Edge compute runtime
• Stream - Video upload, storage, and playback
• Direct creator uploads - One-time upload URLs
• Signed URLs - Tokenized playback