화질 세트 생성

Live Station 에서 사용할 화질 세트를 생성하는 API 입니다. 생성한 화질 세트 조회를 위해 화질 세트 목록 조회 API와 화질 세트 정보 조회 API를 제공합니다.

요청

POST https://livestation.apigw.ntruss.com/api/v2/qualitySets

요청 헤더

요청 바디

응답

예시

요청 예시

HLS 용 화질 세트 생성

POST /api/v2/qualitySets
HOST: livestation.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-timestamp:1521787414578
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
x-ncp-region_code:KR

{  
   "enableHlsTimedMetadata":true,
   "name":"myqualityset",
   "qualityIds":[
      4,
      5
   ],
   "segmentCount":3,
   "segmentDuration":3000,
   "timedMetadata":{
      "header":"ncloud.livestation.metadata",
      "interval":1000,
      "key":"utc"
   }
}

Low Latency 용 화질 세트 생성

POST /api/v2/qualitySets
HOST: livestation.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-timestamp:1521787414578
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
x-ncp-region_code:KR
{
  "enableHlsTimedMetadata": true,
  "isEnabledUll": true,
  "name": "myqualityset",
  "qualityIds": [
    1,2
  ],
  "timedMetadata": {
    "header": "ncloud.livestation.metadata",
    "interval": 1000,
    "key": "utc"
  }
}

응답 예시

HLS 용 화질 세트 생성 응답

HTTP/1.1 200 OK
Server: nginx
Date: Wed, 12 Sep 2018 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{
    "content": {
        "createdTime": 1585656720798,
        "enableHlsTimedMetadata": true,
        "genType": "CUSTOM",
        "id": 23,
        "name": "testquality-api",
        "qualities": [
            {
                "audio": {
                    "bypass": false,
                    "bitrate": 128,
                    "channels": 0,
                    "codec": "AAC",
                    "profile": "LC",
                    "samplerate": 48000
                },
                "genType": "SYSTEM",
                "id": 4,
                "name": "720p-16-9",
                "status": "CREATED",
                "type": "NORMAL",
                "video": {
                    "bypass": false,
                    "bframes": 0,
                    "bitrate": 2500000,
                    "codec": "H264",
                    "fps": 30.0,
                    "height": 720,
                    "level": -1,
                    "profile": "MAIN",
                    "rateControl": "VBR",
                    "videoH264ParamRefFrames": 1,
                    "width": 1280
                }
            },
            {
                "audio": {
                    "bypass": false,
                    "bitrate": 128,
                    "channels": 0,
                    "codec": "AAC",
                    "profile": "LC",
                    "samplerate": 48000
                },
                "genType": "SYSTEM",
                "id": 5,
                "name": "720p-9-16",
                "status": "CREATED",
                "type": "NORMAL",
                "video": {
                    "bypass": false,
                    "bframes": 0,
                    "bitrate": 2500000,
                    "codec": "H264",
                    "fps": 30.0,
                    "height": 1280,
                    "level": -1,
                    "profile": "MAIN",
                    "rateControl": "VBR",
                    "videoH264ParamRefFrames": 1,
                    "width": 720
                }
            }
        ],
        "qualityIds": [
            4,
            5
        ],
        "segmentCount": 3,
        "segmentDuration": 3000,
        "status": "CREATED",
        "timedMetadata": {
            "header": "ncloud.livestation.metadata",
            "interval": 1000,
            "key": "utc"
        }
    },
    "result": "success"
}

Low Latency 화질 세트 생성 응답

HTTP/1.1 200 OK
Server: nginx
Date: Wed, 12 Sep 2018 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{
  "content": {
    "disabled": false,
    "id": 246,
    "status": "CREATED",
    "createdTime": 1666009295544,
    "genType": "CUSTOM",
    "name": "testquality-llhls",
    "qualityIds": [
      1,
      2
    ],
    "qualities": [
      {
        "disabled": false,
        "id": 1,
        "status": "CREATED",
        "createdTime": 1546300800000,
        "genType": "SYSTEM",
        "name": "bypass",
        "type": "BYPASS",
        "video": {},
        "audio": {
          "bypass": true
        }
      },
      {
        "disabled": false,
        "id": 2,
        "status": "CREATED",
        "createdTime": 1546300800000,
        "genType": "SYSTEM",
        "name": "1080p-16-9",
        "type": "NORMAL",
        "video": {
          "fps": 30,
          "bitrate": 5000000,
          "bframes": 0,
          "level": -1,
          "width": 1920,
          "height": 1080,
          "bypass": false,
          "codec": "H264",
          "profile": "HIGH",
          "rateControl": "VBR",
          "videoH264ParamRefFrames": 1
        },
        "audio": {
          "codec": "AAC",
          "profile": "LC",
          "samplerate": 48000,
          "channels": 0,
          "bitrate": 192,
          "bypass": false
        }
      }
    ],
    "enableHlsTimedMetadata": true,
    "isEnabledUll": true,
    "targetLatency": 3,
    "timedMetadata": {
      "key": "utc",
      "header": "ncloud.livestation.metadata",
      "interval": 1000
    }
  }
}