v2 · stable

Media delivery, built for scale

Nimbus is a content delivery layer for video and audio assets. Stream fragments, resolve manifests and pull download segments over a single HTTPS surface, edge-cached across regions.

Read the docs API reference

Service status

99.98%
uptime · 90d

41 ms
median edge latency

Operational
all regions

Endpoints

GET /video/download/{fragment_id} Fetch a media fragment

HEAD /video/download/{fragment_id} Fragment metadata & length

GET /manifest/{asset_id}.m3u8 HLS playback manifest

POST /session/init Open a delivery session

GET /assets List available assets

Quickstart

# Open a delivery session
curl -X POST https://play.example/session/init \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"asset_id":"a1f4","quality":"1080p"}'

# → returns a fragment cursor
# Pull the first fragment
curl https://play.example/video/download/fragment.mp4 \
  -H "Cookie: session_id=<cursor>" \
  --output part-000.mp4

Parameters

Name	In	Description
`asset_id`	body	Identifier of the media asset to deliver.
`quality`	body	Requested rendition: 480p, 720p, 1080p, source.
`session_id`	cookie	Delivery cursor returned by `/session/init`.
`Range`	header	Standard byte-range request for partial fragments.