채널 생성

Prev Next

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

참고

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

요청

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

메서드 URI
POST /api/fin-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 유형
  • CDN_PLUS
cdn.cdnInstanceNo Integer Optional CDN 인스턴스 아이디
  • cdn.createCdn이 false인 경우, 필수 입력
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 모두 스트리밍 가능한 옵션

요청 예시

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

curl --location --request POST 'https://livestation.apigw.ntruss.com/api/fin-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: FKR' \
--header 'Content-Type: application/json' \
--data '{
    "channelName": "V2lTestChannel",
    "cdn": {
        "createCdn": false,
        "cdnDomain": "*************.cdn.beta.ntruss.com",
        "cdnInstanceNo": 11577,
    },
    "qualitySetId": 3,
    "envType": "REAL",
    "outputProtocol": "HLS"
}'

응답

응답 형식을 설명합니다.

응답 바디

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

필드 타입 필수 여부 설명
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 유형
  • CDN_PLUS
content.cdn.cdnInstanceNo Integer - CDN 인스턴스 아이디
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 (유효 값)

응답 상태 코드

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

응답 예시

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

{
    "content": {
        "channelName": "V2lTestChannel",
        "instanceNo": 10******4,
        "cdn": {
            "createCdn": false,
            "cdnType": "CDN_PLUS",
            "cdnInstanceNo": 1****,
            "profileId": 4207,
            "regionType": "KOREA"
        },
        "qualitySetId": 3,
        "useDvr": false,
        "envType": "REAL",
        "outputProtocol": "HLS",
        "channelId": "ls-20250820******-qdrMQ",
        "type": "VOD"
    }
}