Streams

Get clips

Get list of non expired instant clips for a stream.

You can now use both MP4 just-in-time packager and HLS for all clips. Get URLs from “hls_master” and “mp4_master”.

How to download renditions of clips: URLs contain “master” alias by default, which means maximum available quality from ABR set (based on height metadata). There is also possibility to access individual bitrates from ABR ladder. That works for both HLS and MP4. You can replace manually “master” to a value from renditions list in order to get exact bitrate/quality from the set. Example:

HLS 720p: https://CID.domain.com/rec/`111_1000`/`rec_d7bsli54p8n4_qsid42_master`.m3u8
HLS 720p: https://CID.domain.com/rec/`111_1000`/`rec_d7bsli54p8n4_qsid42_media_1_360`.m3u8
MP4 360p: https://CID.domain.com/rec/`111_1000`/`rec_d7bsli54p8n4_qsid42_master`.mp4
MP4 360p: https://CID.domain.com/rec/`111_1000`/`rec_d7bsli54p8n4_qsid42_media_1_360`.mp4

GET

streaming

streams

{stream_id}

clip_recording

curl --request GET \
  --url https://api.gcore.com/streaming/streams/{stream_id}/clip_recording \
  --header 'Authorization: <api-key>'

[
  {
    "id": "d7bsli54p8n4",
    "created_at": "2024-01-05T20:15:00.000Z",
    "vod_required": true,
    "video_id": 459857,
    "renditions": [
      "media_1_360",
      "media_2_468",
      "media_3_720",
      "media_4_1080"
    ],
    "hls_master": "https://CID.domain.com/rec/12345_330031/rec_d7bsli54p8n4_qsid42_master.m3u8",
    "mp4_master": "https://CID.domain.com/rec/12345_330031/rec_d7bsli54p8n4_qsid42_master.mp4",
    "start": 1716559200,
    "duration": 60,
    "expiration": 1716562860
  }
]

Authorizations

Authorization

string

header

required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Path Parameters

stream_id

integer

required

Stream ID

Response

200

application/json

Successful

The response is of type object[].

Stop recording Create clip

curl --request GET \
  --url https://api.gcore.com/streaming/streams/{stream_id}/clip_recording \
  --header 'Authorization: <api-key>'

[
  {
    "id": "d7bsli54p8n4",
    "created_at": "2024-01-05T20:15:00.000Z",
    "vod_required": true,
    "video_id": 459857,
    "renditions": [
      "media_1_360",
      "media_2_468",
      "media_3_720",
      "media_4_1080"
    ],
    "hls_master": "https://CID.domain.com/rec/12345_330031/rec_d7bsli54p8n4_qsid42_master.m3u8",
    "mp4_master": "https://CID.domain.com/rec/12345_330031/rec_d7bsli54p8n4_qsid42_master.mp4",
    "start": 1716559200,
    "duration": 60,
    "expiration": 1716562860
  }
]

Gcore Website

Gcore Status

Streams

Get clips

Get list of non expired instant clips for a stream.

You can now use both MP4 just-in-time packager and HLS for all clips. Get URLs from “hls_master” and “mp4_master”.

HLS 720p: https://CID.domain.com/rec/`111_1000`/`rec_d7bsli54p8n4_qsid42_master`.m3u8
HLS 720p: https://CID.domain.com/rec/`111_1000`/`rec_d7bsli54p8n4_qsid42_media_1_360`.m3u8
MP4 360p: https://CID.domain.com/rec/`111_1000`/`rec_d7bsli54p8n4_qsid42_master`.mp4
MP4 360p: https://CID.domain.com/rec/`111_1000`/`rec_d7bsli54p8n4_qsid42_media_1_360`.mp4

GET

streaming

streams

{stream_id}

clip_recording

curl --request GET \
  --url https://api.gcore.com/streaming/streams/{stream_id}/clip_recording \
  --header 'Authorization: <api-key>'

[
  {
    "id": "d7bsli54p8n4",
    "created_at": "2024-01-05T20:15:00.000Z",
    "vod_required": true,
    "video_id": 459857,
    "renditions": [
      "media_1_360",
      "media_2_468",
      "media_3_720",
      "media_4_1080"
    ],
    "hls_master": "https://CID.domain.com/rec/12345_330031/rec_d7bsli54p8n4_qsid42_master.m3u8",
    "mp4_master": "https://CID.domain.com/rec/12345_330031/rec_d7bsli54p8n4_qsid42_master.mp4",
    "start": 1716559200,
    "duration": 60,
    "expiration": 1716562860
  }
]

Authorizations

Authorization

string

header

required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Path Parameters

stream_id

integer

required

Stream ID

Response

200

application/json

Successful

The response is of type object[].

Stop recording Create clip

curl --request GET \
  --url https://api.gcore.com/streaming/streams/{stream_id}/clip_recording \
  --header 'Authorization: <api-key>'

[
  {
    "id": "d7bsli54p8n4",
    "created_at": "2024-01-05T20:15:00.000Z",
    "vod_required": true,
    "video_id": 459857,
    "renditions": [
      "media_1_360",
      "media_2_468",
      "media_3_720",
      "media_4_1080"
    ],
    "hls_master": "https://CID.domain.com/rec/12345_330031/rec_d7bsli54p8n4_qsid42_master.m3u8",
    "mp4_master": "https://CID.domain.com/rec/12345_330031/rec_d7bsli54p8n4_qsid42_master.mp4",
    "start": 1716559200,
    "duration": 60,
    "expiration": 1716562860
  }
]

Get clips

Authorizations

Path Parameters

Response

Overview

IAM

CDN

Managed DNS

Cloud

Security

FastEdge

WAAP

Video Streaming

Object Storage

Get clips

Authorizations

Path Parameters

Response