QualitySets

Get all quality sets

Method returns a list of all custom quality sets.

Transcoding is designed to minimize video file size while maintaining maximum visual quality. This is done so that the video can be delivered and viewed on any device, on any Internet connection, anywhere in the world. It’s always a compromise between video/audio quality and delivery+viewing quality (QoE).

Our experts have selected the optimal parameters for transcoding, to ensure maximum video/audio quality with the best compression. Default quality sets are described in the documentation. These values are the default for everyone. There is no need to configure anything additional. Read more about qiality in our blog How we lowered the bitrate for live and VOD streaming by 32.5% without sacrificing quality. Quality ladder Only for those cases when, in addition to the main parameters, it is necessary to use your own, then it is necessary to use custom quality sets. How to use:

By default custom quality set is empty – { "live":[],"vod":[] }
Request the use of custom quality sets from your manager or the Support Team.
Please forward your requirements to us, since the parameters are set not by you, but by our engineers. (We are working to ensure that later you can create qualities by yourself.)
Use the created quality sets through the these specified API methods. Here are some common parameters of quality settings:

Resolution: Determines the size of the video frame. I.e. 720p, 1080p, 4K, etc.
Bitrate: Refers to the amount of data processed per unit of time.
Codec: Codec used for transcoding can significantly affect quality. Popular codecs include H.264 (AVC), H.265 (HEVC), and AV1.
Frame Rate: Determines how many frames per second are displayed. Common frame rates include 24fps, 30fps, and 60fps.
Color Depth and Chroma Subsampling: These settings determine the accuracy of color representation in the video.
Audio Bitrate and Codec: Don’t forget about the audio :) Bitrate and codec used for audio can also affect the overall quality. Note: Custom quality set is a paid feature.

GET

streaming

quality_sets

Get all quality sets

curl --request GET \
  --url https://api.gcore.com/streaming/quality_sets \
  --header 'Authorization: <api-key>'

{
  "live": [
    {
      "id": 77,
      "name": "Live 4K UHD 60fps AV1 (custom)",
      "default": true,
      "qualities": [
        {
          "id": 1,
          "name": "vod2160n"
        },
        {
          "id": 2,
          "name": "vod1440n"
        }
      ]
    }
  ],
  "vod": []
}

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

Response

200

application/json

Successful

The response is of type object.

Get playlist videos Set defaults for quality sets

Get all quality sets

curl --request GET \
  --url https://api.gcore.com/streaming/quality_sets \
  --header 'Authorization: <api-key>'

{
  "live": [
    {
      "id": 77,
      "name": "Live 4K UHD 60fps AV1 (custom)",
      "default": true,
      "qualities": [
        {
          "id": 1,
          "name": "vod2160n"
        },
        {
          "id": 2,
          "name": "vod1440n"
        }
      ]
    }
  ],
  "vod": []
}

Overview

IAM

CDN

Managed DNS

Cloud

DDoS Protection

FastEdge

WAAP

Streaming

Object Storage

Get all quality sets

Authorizations

Response