Stream Media
Media
Stream Media
Stream audio or video content from decentralized storage protocols like Arweave and IPFS. This endpoint acts as a proxy that handles decentralized storage protocols and enables partial content streaming for media players.
Supported URL formats:
ar://- Arweave URLs (e.g.,ar://abc123...)ipfs://- IPFS URLs (e.g.,ipfs://Qm...)https://- Direct HTTPS URLs
The endpoint supports HTTP Range headers for seeking within media files, returning 206 Partial Content when range requests are supported by the origin.
GET
Stream Media
This endpoint is public and does not require authentication.
Overview
The Media Stream API enables streaming audio and video content from decentralized storage protocols like Arweave and IPFS. It acts as a proxy that:- Converts
ar://andipfs://URLs to fetchable gateway URLs - Supports HTTP Range requests for seeking within media files
- Returns proper headers for audio and video players to function correctly
Supported URL Formats
| Protocol | Format | Example |
|---|---|---|
| Arweave | ar:// | ar://abc123xyz... |
| IPFS | ipfs:// | ipfs://QmXyz... |
| HTTPS | https:// | https://arweave.net/abc123... |
Range Request Support
The endpoint supports HTTP Range headers, allowing media players to seek to specific positions in the file. When a range request is made and supported by the origin:- Returns
206 Partial Contentstatus - Includes
Content-Rangeheader indicating the byte range - Enables efficient streaming without downloading the entire file
Example Usage
Basic Audio Request
Basic Video Request
With Range Header (for seeking)
In an HTML Audio Element
In an HTML Video Element
Query Parameters
The URL of the media file to stream. Supports Arweave (ar://), IPFS (ipfs://), and HTTPS URLs.
Response
Full media content returned
The response is of type file.