Create channel

Available in Classic and VPC

Create a channel for VOD streaming.

Request

This section describes the request format. The method and URI are as follows:

Request headers

For information about the headers common to all VOD Station APIs, see VOD Station request headers.

Request body

You can include the following data in the body of your request:

encryptionList

The following describes encryptionList.

Request example

The request example is as follows:

• When applying media encryption (MediaEncryption; AES-128)

  curl --location --request POST 'https://vodstation.apigw.ntruss.com/api/v2/channels' \
  --header 'x-ncp-apigw-timestamp: {Timestamp}' \
  --header 'x-ncp-iam-access-key: {Access Key}' \
  --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
  --data '{
      "name": "ch-media-encrypt",
      "storageBucketName": "station-000",
      "accessPrivateFiles": true,
      "protocolList": ["HLS"],
      "encryptionList": [
          {
              "protocol": "HLS",
              "mediaEncryptTypeCode": 1
          }
      ],
      "segmentDuration": 10,
      "segmentDurationOption": "BASIC",
      "createCdn": true,
      "cdn": {
          "profileId": ****,
          "regionType": "KOREA",
          "type": "GLOBAL_EDGE"
      }
  }'
  

Response

This section describes the response format.

Response body

The response body includes the following data:

encryptList

The following describes encryptList.

Response status codes

For information about the HTTP status codes common to all VOD Station APIs, see VOD Station response status codes.

Response example

The response example is as follows:

{
    "content": {
        "disabled": false,
        "id": "vs-20250821095732-*******",
        "name": "ch-media-encrypt",
        "channelStatus": "CREATING",
        "storageBucketName": "station-000",
        "segmentDuration": 10,
        "protocolList": [
            "HLS"
        ],
        "createTime": 1755737852,
        "cdnCreatedTime": 1755737852,
        "playUrl": "https://cpzplvi******.edge.naverncp.com/[protocol]/[Object Storage Bucket(encryption name)]/[path]/[video filename]/[manifest]",
        "cdnStatus": "CREATING",
        "cdnDomain": "cpzplvi******.edge.naverncp.com",
        "cdnServiceName": "edge-vs-20250821095732-*******",
        "storageBucketStatus": "RUNNING",
        "originPath": "vs2-k1.video.media.ntruss.com/2706412/vs-20250821095732-*******",
        "encryptList": [
            {
                "protocol": "HLS",
                "mediaEncryptTypeCode": 1
            }
        ],
        "accessPrivateFiles": true,
        "encryptedBucketName": "*****VzPmKvIthkozoufHw__",
        "segmentDurationOption": "BASIC",
        "cdn": {
            "cdnType": "GLOBAL_EDGE",
            "cdnDomain": "cpzplvi******.edge.naverncp.com",
            "cdnServiceName": "edge-vs-20250821095732-*******",
            "profileId": ****,
            "regionType": "KOREA",
            "cdnInstanceNo": *****
        }
    }
}

Set streaming video security

Various settings are available to secure video content for streaming on the channel you create.

Content access control

By integrating with the Global Edge service, you can restrict access to streaming video content through Global Edge's content authentication control. Content authentication control methods include Signed URL and JSON Web Token. See Signed URL and JSON Web Token in the Global Edge user guide for how to use each method.

• When issuing an authentication token, you must enter the wildcard path under ACL for Signed URL and path for JSON Web Token respectively.
  • Single bitrate playback: /[protocol]/[encryptedBucketName]/[path]/[video filename]/*
    • Example:
      • HLS: https://example.edge.navercorp.com/hls/guide/vod-5100k.mp4/index.m3u8
        • wildcard path : /hls/guide/vod-5100k.mp4/*
      • DASH: https://example.edge.navercorp.com/dash/guide/vod-5100k.mp4/index.m3u8
        • wildcard path: /dash/guide/vod-5100k.mp4/*
  • Adaptive bitrate playback: /[protocol]/[encryptedBucketName]/[path]/[prefix],[video filenames],[suffix].smil/*
    • Example:
      • HLS playback address: https://example.edge.navercorp.com/hls/guide/abr/vod-,5400,2400,1200,0900,0600,0300,k.mp4.smil/master.m3u8
        • wildcard path: /hls/guide/abr/vod-,5400,2400,1200,0900,0600,0300,k.mp4.smil/*
      • DASH playback address: https://example.edge.navercorp.com/dash/guide/abr/vod-,5400,2400,1200,0900,0600,0300,k.mp4.smil/manifest.mpd
        • wildcard path: /dash/guide/abr/vod-,5400,2400,1200,0900,0600,0300,k.mp4.smil/*
• You must set Edge Auth to the output protocol of the channel that created Edge Auth in the cache settings of Global Edge. For more information, see the Global Edge API guide.
  • Extensions excluded from authentication
    • .ts, .mp4, .m4s, .vtt, .key
  • Extension that forwards the authentication token to the source
    • .m3u8, .mpd

Content protection

By integrating with the One Click Multi DRM service, you can encrypt and stream video content through multi DRM to prevent piracy and distribution. You can easily set DRM features through the drm object when creating a channel, and multi DRM is applied according to the selected output protocol. For more information on encryption methods by DRM technology, supported devices, platforms, and versions, etc., see the VOD Station user guide and DoveRunner (formerly PallyCon) guide.