채널 생성

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

VOD2LIVE 채널을 생성합니다. VOD2LIVE는 녹화 파일을 이용하여 라이브 방송의 스트리밍 소스로 활용할 수 있는 기능입니다. 현재 시간을 기준으로 14일 이내에 생방송으로 송출할 수 있으며, 최대 24시간까지 여러 개의 파일을 송출할 수 있습니다. 이 기능을 활용하여 미리 준비된 영상으로 라이브 방송을 구성할 수 있습니다.

참고

VOD2LIVE 채널의 생성 옵션은 일반 라이브 채널과 동일하므로 자세한 내용은 Channel Management의 채널 생성을 참조해 주십시오.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
POST /api/v2/vod/channels

요청 헤더

Live Station API에서 공통으로 사용하는 헤더에 대한 정보는 Live Station 요청 헤더를 참조해 주십시오.

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
channelName String Required 채널 이름
  • 한글, 영문자, 숫자, 특수 문자 '_'를 허용하며, 3~20자 이내로 입력
cdn Object Required CDN 설정
cdn.createCdn Boolean Required CDN 신규 생성 여부
  • true | false
    • true: 신규 생성
    • false: 보유 CDN 사용
cdn.cdnType String Required CDN 유형
  • GLOBAL_EDGE (유효 값)
cdn.cdnDomain String Conditional Global Edge 도메인
cdn.profileId Integer Required Global Edge 프로필 아이디
cdn.cdnInstanceNo Integer Conditional Global Edge 인스턴스 아이디
cdn.regionType String Conditional Global Edge 서비스 지역
  • KOREA | JAPAN | GLOBAL
    • KOREA: 한국
    • JAPAN: 일본
    • GLOBAL: 글로벌
  • cdn.createCdn이 true인 경우, 필수 입력
qualitySetId Integer Required 화질 설정 아이디
envType String Optional 채널 타입
  • REAL (기본값) | DEV | STAGE
  • 적용할 서비스 환경에 따른 구분자
outputProtocol String Optional Output Protocol 설정
  • HLS (기본값) | LL_HLS | HLS,DASH
    • HLS: 안정적이고 호환성 높은 HLS 스트리밍을 이용하기 위한 옵션
    • LL_HLS: CMAF을 이용한 저지연 HLS 스트리밍을 위한 옵션
    • HLS,DASH: 일반 HLS와 Dash 모두 스트리밍 가능한 옵션
drmEnabledYn Boolean Required Multi DRM 사용 여부
  • true | false
    • true: 사용
    • false: 사용 안 함
drm Object Conditional Multi DRM 설정
  • drmEnabledYn이 true인 경우, 필수 입력
drm.siteId String Conditional 사이트 아이디
drm.contentId String Conditional 콘텐츠 아이디
  • 영문자, 숫자, 특수 문자 '-', '_'를 허용하며, 3~100자 이내로 입력

요청 예시

요청 예시는 다음과 같습니다.

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"
    }
}'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
content Object - 응답 결과
content.channelName String - 채널 이름
content.instanceNo Integer - 채널 인스턴스 번호
content.cdn Object - CDN 설정
content.cdn.createCdn Boolean - CDN 신규 생성 여부
  • true | false
    • true: 신규 생성
    • false: 보유 CDN 사용
content.cdn.cdnType String - CDN 유형
  • GLOBAL_EDGE (유효 값)
content.cdn.cdnInstanceNo Integer - Global Edge 인스턴스 아이디
content.cdn.profileId Integer - Global Edge 프로필 아이디
content.cdn.regionType String - Global Edge 서비스 지역
  • KOREA | JAPAN | GLOBAL
    • KOREA: 한국
    • JAPAN: 일본
    • GLOBAL: 글로벌
content.qualitySetId Integer - 화질 설정 아이디
content.useDvr Boolean - 타임머신 설정 여부
  • true | false
    • true: 설정
    • false: 설정 안 함
content.envType String - 채널 타입
  • DEV | STAGE | REAL
content.outputProtocol String - Output Protocol
content.channelId String - 채널 아이디
content.type String - 채널 유형
  • VOD (유효 값)
content.drmEnabledYn Boolean - Multi DRM 사용 여부
  • true | false
    • true: 사용
    • false: 사용 안 함
content.drm Object - Multi DRM 설정
  • content.drmEnabledYn이 true인 경우, 하위 정보 표시
content.drm.siteId String - 사이트 아이디
content.drm.contentId String - 콘텐츠 아이디

응답 상태 코드

Live Station API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Live Station 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
    "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"
        }
    }
}