Reference
Source requirements
We pass your video through without re-encoding it, which keeps quality intact and latency low. That only works if the source meets these requirements.
A stream outside these requirements may need transcoding, which we will tell you about rather than do silently.
Transport, SRT
| Property | Requirement |
|---|---|
| Mode | Your side in listener mode; we call |
| Payload | MPEG-TS |
| Encryption | None. Encrypted SRT is not supported yet |
| Passphrase length | 10 to 79 characters |
| Latency | 120 to 1000 ms, 200 ms recommended |
| Availability | Listener up from a few minutes before ingestStartTime |
Transport, RTMP
| Property | Requirement |
|---|---|
| Mode | Your RTMP server accepts our pull; we call |
| URL | rtmp://host/app/streamKey, reachable from our egress range |
| Codecs | H.264 video, AAC audio, as in the tables below |
| Availability | Stream published from a few minutes before ingestStartTime |
Transport, HLS
| Property | Requirement |
|---|---|
| Manifest | Live .m3u8 over HTTPS, media or master playlist |
| Segments | MPEG-TS or fMP4 |
| Segment duration | 2 to 6 seconds |
| Playlist window | At least 6 segments, so a brief poll delay loses nothing |
| Authentication | Signed URL. The headers field is not applied yet |
| URL validity | Must outlast ingestStartTime plus the full match |
| Availability | Manifest live from a few minutes before ingestStartTime |
HLS is easier to supply and adds latency, because we are inherently a few segments behind the live edge. That is fine for clip generation, which is not real-time, but SRT is the better choice if you ever want us closer to live. Do not point us at a playlist whose window is only three segments long: a single slow poll then drops footage permanently.
Video
| Property | Requirement |
|---|---|
| Codec | H.264, High profile, level 4.0 or above |
| Resolution | 1920x1080 preferred, 1280x720 accepted |
| Frame rate | Constant. 25, 50, 29.97 or 59.94 |
| Scan | Progressive |
| Bitrate | 6 to 12 Mbps, CBR preferred |
| GOP | Closed, fixed 2-second interval |
Audio
| Property | Requirement |
|---|---|
| Codec | AAC-LC |
| Sample rate | 48 kHz |
| Bitrate | 128 kbps or above per stereo pair |
| Tracks | Up to 8, each declared in audioTracks |
| Layout | Mono or stereo per track |
A separate ambient or clean-effects track is worth sending if your production has one. It lets clips ship with crowd and pitch sound but no commentary, which is usually what social edits want, and it avoids commentary rights following the clip.