Available in Classic and VPC
Create a VOD2LIVE channel. VOD2LIVE is a feature that allows you to utilize a recorded file as the streaming source for a live broadcast. You can go live within 14 days of the current time, and you can stream multiple files up to 24 hours in advance. You can utilize this feature to organize your live broadcast with pre-prepared footage.
The creation options for VOD2LIVE channels are the same as for general live channels, so see Create channel in Channel Management for more information.
Request
This section describes the request format. The method and URI are as follows:
Method | URI |
---|---|
POST | /api/v2/vod/channels |
Request headers
For information about the headers common to all Live Station APIs, see Live Station request headers.
Request body
You can include the following data in the body of your request:
Field | Type | Required | Description |
---|---|---|---|
channelName |
String | Required | Channel name
|
cdn |
Object | Required | Set up CDN. |
cdn.createCdn |
Boolean | Required | Whether to create a new CDN
|
cdn.cdnType |
String | Required | CDN type
|
cdn.cdnDomain |
String | Conditional | Global Edge domain
|
cdn.profileId |
Integer | Required | Global Edge profile ID
|
cdn.cdnInstanceNo |
Integer | Conditional | Global Edge instance ID
|
cdn.regionType |
String | Conditional | Global Edge Service Region
|
qualitySetId |
Integer | Required | Image quality setting ID
|
envType |
String | Optional | Channel type
|
outputProtocol |
String | Optional | Output protocol settings
|
drmEnabledYn |
Boolean | Required | Multi DRM usage
|
drm |
Object | Conditional | Multi DRM settings
|
drm.siteId |
String | Conditional | Site ID
|
drm.contentId |
String | Conditional | Content ID
|
Request example
The request example is as follows:
curl --location --request POST 'https://livestation.apigw.ntruss.com/api/v2/vod/channels' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-region_code: KR' \
--header 'Content-Type: application/json' \
--data '{
"channelName": "V2lTestChannel",
"cdn": {
"createCdn": false,
"cdnType": "GLOBAL_EDGE",
"cdnDomain": "*************.edge.naverncp.com",
"profileId": 4207,
"cdnInstanceNo": 11577,
"regionType": "KOREA"
},
"qualitySetId": 3,
"envType": "REAL",
"outputProtocol": "HLS",
"drmEnabledYn": true,
"drm": {
"siteId": "drm-20250814******-gJMis",
"contentId": "my-Test-Multidrm"
}
}'
Response
This section describes the response format.
Response body
The response body includes the following data:
Field | Type | Required | Description |
---|---|---|---|
content |
Object | - | Response result |
content.channelName |
String | - | Channel name |
content.instanceNo |
Integer | - | Channel instance number |
content.cdn |
Object | - | Set up CDN. |
content.cdn.createCdn |
Boolean | - | Whether to create a new CDN
|
content.cdn.cdnType |
String | - | CDN type
|
content.cdn.cdnInstanceNo |
Integer | - | Global Edge instance ID |
content.cdn.profileId |
Integer | - | Global Edge profile ID |
content.cdn.regionType |
String | - | Global Edge Service Region
|
content.qualitySetId |
Integer | - | Image quality setting ID |
content.useDvr |
Boolean | - | Time machine settings
|
content.envType |
String | - | Channel type
|
content.outputProtocol |
String | - | Output Protocol |
content.channelId |
String | - | Channel ID |
content.type |
String | - | Channel type
|
content.drmEnabledYn |
Boolean | - | Multi DRM usage
|
content.drm |
Object | - | Multi DRM settings
|
content.drm.siteId |
String | - | Site ID |
content.drm.contentId |
String | - | Content ID |
Response status codes
For information about the HTTP status codes common to all Live Station APIs, see Live Station response status codes.
Response example
The response example is as follows:
{
"content": {
"channelName": "V2lTestChannel",
"instanceNo": 10******4,
"cdn": {
"createCdn": false,
"cdnType": "GLOBAL_EDGE",
"cdnInstanceNo": 1****,
"profileId": 4207,
"regionType": "KOREA"
},
"qualitySetId": 3,
"useDvr": false,
"envType": "REAL",
"outputProtocol": "HLS",
"channelId": "ls-20250820******-qdrMQ",
"type": "VOD",
"drmEnabledYn": true,
"drm": {
"siteId": "drm-20250814******-gJMis",
"contentId": "my-Test-Multidrm"
}
}
}