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 'APIKey: <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

APIKey

string

header

required

API key for authentication.

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 'APIKey: <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
  }
]

Overview

IAM

CDN

Managed DNS

Cloud

Security

FastEdge

WAAP

Web Security

Video Streaming

Object Storage

Get clips

Authorizations

Path Parameters

Response