Skip to content

Video Streaming

Stream video content using HLS or DASH protocols with adaptive playback.

Stream video with HLS (HTTP Live Streaming)

Convert and stream videos using Apple HLS protocol for adaptive playback across devices.

# Trigger HLS conversion (one-time, cached)
curl -X POST "/api/v1/tenants/:tenantId/buckets/:bucketId/files/:fileId/streams/hls?apiKey=<your-api-key>"

# Get HLS playlist
curl "/api/v1/tenants/:tenantId/buckets/:bucketId/files/:fileId/streams/hls/playlist.m3u8?apiKey=<your-api-key>"

# Get individual segment
curl "/api/v1/tenants/:tenantId/buckets/:bucketId/files/:fileId/streams/hls/index0.ts?apiKey=<your-api-key>"

Stream video with DASH (Dynamic Adaptive Streaming)

Convert and stream videos using MPEG-DASH protocol for browser-based players.

# Trigger DASH conversion (one-time, cached)
curl -X POST "/api/v1/tenants/:tenantId/buckets/:bucketId/files/:fileId/streams/dash?apiKey=<your-api-key>"

# Get DASH manifest
curl "/api/v1/tenants/:tenantId/buckets/:bucketId/files/:fileId/streams/dash/manifest.mpd?apiKey=<your-api-key>"

Embed a video player

GFile provides built-in embeddable HTML video players with customizable options.

# HLS player (embed in iframe)
/api/v1/tenants/:tenantId/buckets/:bucketId/files/:fileId/streams/hls?controls=true&autoplay=true&muted=true&apiKey=<your-api-key>

# DASH player
/api/v1/tenants/:tenantId/buckets/:bucketId/files/:fileId/streams/dash?controls=true&width=800&height=450&apiKey=<your-api-key>

Player parameters:

Parameter Description
controls Show player controls
autoplay Auto-start playback
muted Start muted
width Player width
height Player height
seek Start time (seconds)
repeat Loop playback
speed Playback speed