Streams

Create live stream

Use this method to create a new live stream entity for broadcasting.

The input in API may contain streams of different formats, including the most common ones RTMP, RTMPS, SRT, HLS. Note that multicast MPEG-TS over UDP and others are supported too, ask the Support Team please. For ingestion, you can use both PUSH and PULL methods. Also you can use the main and backup servers, which are geographically located in different locations. By default, any free ingest points in the world are used. Settings have been applied that deliver low-latency streams in the optimal way. If for some reason you need to set a fixed ingest point, or if you need to set the main and backup ingest points in the same region (for example, do not send streams outside the EU or US), then contact our Support Team.

The output is HLS and MPEG-DASH with ABR. We transcode video for you by our cloud-based infrastructure. ABR ladder supports all qualities from SD to 8K HDR 60fps. All our streams are Low Latency enabled. We support a delay of ±4 seconds for video streams by utilizing Common Media Application Format (CMAF) technology. So you obtain latency from the traditional 30-50 seconds to ±4 seconds only by default. If you need legacy non-low-latency HLS, then look at HLS MPEGTS delivery below.

You have access to additional functions such as:

DVR
Recording
Live clipping
Restreaming
(soon) AI Automatic Speech Recognition for subtitles/captions generating

For more information see specific API methods, and the Knowledge Base. To organize streaming with ultra-low latency, look for WebRTC delivery in different section in the Knowledge Base. HTML Overlays

POST

streaming

streams

curl --request POST \
  --url https://api.gcore.com/streaming/streams \
  --header 'APIKey: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Live stream by user e4d0f942-f35d",
  "pull": true,
  "active": true,
  "auto_record": false,
  "client_user_id": 1001,
  "uri": "srt://domain.com:5000/?streamid=12345",
  "html_overlay": false
}'

{
  "name": "Live stream by user e4d0f942-f35d",
  "pull": false,
  "active": true,
  "auto_record": false,
  "client_user_id": 1001,
  "uri": null,
  "html_overlay": false,
  "id": 1080200,
  "live": true,
  "backup_live": false,
  "push_url": "rtmp://vp-push-anx2.domain.com/in/123?08cd54f0",
  "backup_push_url": "rtmp://vp-push-ed1.domain.com/in/123b?08cd54f0",
  "push_url_srt": "srt://vp-push-anx2-srt.domain.com:5001?streamid=123#08cd54f0",
  "backup_push_url_srt": "srt://vp-push-anx1-srt.domain.com:5001?streamid=123b#08cd54f0",
  "push_url_whip": "https://whip.gvideo.co/123_561041/whip",
  "created_at": "2023-10-01T00:01:01.000Z",
  "started_at_primary": "2023-10-03T00:01:01.000Z",
  "started_at_backup": null,
  "finished_at_primary": "2023-10-01T23:59:59.000Z",
  "dvr_duration": 3600,
  "iframe_url": "https://demo-public.gvideo.io/streams/2675_19146",
  "dash_url": "https://demo-public.gvideo.io/cmaf/2675_19146/index.mpd",
  "hls_cmaf_url": "https://demo-public.gvideo.io/cmaf/2675_19146/master.m3u8",
  "hls_mpegts_url": "https://demo-public.gvideo.io/mpegts/2675_19146/master_mpegts.m3u8",
  "screenshot": "https://static.gvideo.co/videoplatform/streams/2675/19146/screenshots/last.jpg",
  "recording_duration": 1500,
  "transcoded_qualities": [
    "audioa",
    "360pa",
    "480pa",
    "720pa",
    "1080pa"
  ],
  "transcoding_speed": 1.01,
  "frame_rate": 29.97,
  "video_height": 1080,
  "video_width": 1920
}

Authorizations

APIKey

string

header

required

API key for authentication.

Body

application/json

Response

200

application/json

Successful

The response is of type object.

Get all live streams Get live stream

curl --request POST \
  --url https://api.gcore.com/streaming/streams \
  --header 'APIKey: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Live stream by user e4d0f942-f35d",
  "pull": true,
  "active": true,
  "auto_record": false,
  "client_user_id": 1001,
  "uri": "srt://domain.com:5000/?streamid=12345",
  "html_overlay": false
}'

{
  "name": "Live stream by user e4d0f942-f35d",
  "pull": false,
  "active": true,
  "auto_record": false,
  "client_user_id": 1001,
  "uri": null,
  "html_overlay": false,
  "id": 1080200,
  "live": true,
  "backup_live": false,
  "push_url": "rtmp://vp-push-anx2.domain.com/in/123?08cd54f0",
  "backup_push_url": "rtmp://vp-push-ed1.domain.com/in/123b?08cd54f0",
  "push_url_srt": "srt://vp-push-anx2-srt.domain.com:5001?streamid=123#08cd54f0",
  "backup_push_url_srt": "srt://vp-push-anx1-srt.domain.com:5001?streamid=123b#08cd54f0",
  "push_url_whip": "https://whip.gvideo.co/123_561041/whip",
  "created_at": "2023-10-01T00:01:01.000Z",
  "started_at_primary": "2023-10-03T00:01:01.000Z",
  "started_at_backup": null,
  "finished_at_primary": "2023-10-01T23:59:59.000Z",
  "dvr_duration": 3600,
  "iframe_url": "https://demo-public.gvideo.io/streams/2675_19146",
  "dash_url": "https://demo-public.gvideo.io/cmaf/2675_19146/index.mpd",
  "hls_cmaf_url": "https://demo-public.gvideo.io/cmaf/2675_19146/master.m3u8",
  "hls_mpegts_url": "https://demo-public.gvideo.io/mpegts/2675_19146/master_mpegts.m3u8",
  "screenshot": "https://static.gvideo.co/videoplatform/streams/2675/19146/screenshots/last.jpg",
  "recording_duration": 1500,
  "transcoded_qualities": [
    "audioa",
    "360pa",
    "480pa",
    "720pa",
    "1080pa"
  ],
  "transcoding_speed": 1.01,
  "frame_rate": 29.97,
  "video_height": 1080,
  "video_width": 1920
}

Overview

IAM

CDN

Managed DNS

Cloud

Security

FastEdge

WAAP

Web Security

Video Streaming

Object Storage

Create live stream

Authorizations

Body

Response