Streams

Streams represent individual encoded tracks of a video (video, audio, muxed, or the original file).

Create Stream

Add a new stream to a video.

POST /api/streams

Request Body:

{
  "video_id": 1,
  "name": "720p",
  "type": "video",
  "input_params": {
    "codec": "h264",
    "width": 1280,
    "height": 720,
    "bitrate": "2500k"
  }
}

Update Stream

PUT /api/streams/{id}

Request Body:

{
  "name": "720p Updated",
  "input_params": { ... }
}

Delete Stream

DELETE /api/streams/{id}

Stream Types

Type	Description
original	The source file as uploaded
video	Video-only encoded track
audio	Audio-only encoded track
muxed	Combined video + audio track

Stream Properties

Field	Type	Description
ulid	string	Unique identifier
video_id	integer	Parent video ID
name	string	Display name
type	string	Stream type
width	integer	Video width in pixels
height	integer	Video height in pixels
size	integer	File size in bytes
language	string	Language code (e.g., en, es)
channels	integer	Audio channels
meta	object	FFprobe metadata
input_params	object	Encoding parameters
error_log	string	Error details if the stream's concat job failed