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 |