인코딩 옵션 조회

Prev Next

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

인코딩 옵션의 상세 정보를 조회합니다.

요청

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

메서드 URI
GET /api/v2/encoding-option/{encodingOptionId}

요청 헤더

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

요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
encodingOptionId String Required 인코딩 옵션 아이디

요청 예시

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

curl --location --request GET 'https://vodstation.apigw.ntruss.com/api/v2/encoding-option/1' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

응답

응답 형식을 설명합니다.

응답 바디

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

필드 타입 필수 여부 설명
content Object - 응답 결과
content.disabled Boolean - Sub Account 비활성화 여부
  • true | false
    • true: 비활성
    • false: 활성
content.id Integer - 인코딩 옵션 아이디
content.encodingOptionType String - 인코딩 옵션 타입
  • NORMAL | AUDIO
    • NORMAL: 비디오 인코딩 옵션
    • AUDIO: 오디오 인코딩 옵션
content.name String - 인코딩 옵션 이름
content.format String - 변환된 미디어 파일 컨테이너 포맷
content.video Object - 비디오 인코딩 옵션 정보
content.video.codec String - 비디오 코덱 포맷
content.video.codecOptions Object - 비디오 코덱 상세 옵션 정보
content.video.codecOptions.profile String - 비디오 코덱 프로필(Video Codec Profile)
content.video.codecOptions.level String - 비디오 코덱 레벨(Video Codec Level)
content.video.bitrate Integer - 비디오 스트림의 비트레이트(Kbps)
content.video.width Integer - 출력 비디오의 너비(픽셀)
content.video.height Integer - 출력 비디오의 높이(픽셀)
content.video.framerate Double - 초당 프레임 수(fps)
content.video.maxFramerate Double - 최대 초당 프레임 수(fps)
content.video.keyframeInterval Double - 비디오에 키 프레임이 생성되는 간격(초)
content.video.rateControl String - 비트레이트 배분 방식
  • AUTO | ABR | CRF | CBR
    • AUTO: 자동
    • ABR: 평균 비트레이트(Average Bitrate)
    • CRF: 고정 화질(Constant Rate Factor)
    • CBR: 고정 비트레이트(Constant Bitrate)
content.video.pass String - 비디오 변환 시의 인코딩 패스 설정
  • 1-Pass | 2-Pass
    • 1-Pass: 인코딩 1번 진행
    • 2-Pass: 인코딩 2번 진행
content.audio Object - 오디오 인코딩 옵션 정보
content.audio.codec String - 오디오 코덱 포맷
content.audio.bitrate Integer - 오디오 스트림의 비트레이트(Kbps)
content.audio.channel Integer - 출력 오디오의 채널 수 설정
  • AUTO | 1 | 2
    • AUTO: 자동
    • 1: 모노
    • 2: 스트레오
content.audio.samplingRate Double - 출력 오디오 샘플링 레이트(Hz)
defaultSet Boolean - 기본 인코딩 옵션 설정 여부
  • true | false
    • true: 시스템 제공
    • false: 사용자 생성
content.regionNo String - 리전 번호
  • 1 (유효 값)
    • 1: 한국 리전
content.memberNo Integer - 멤버 번호

응답 상태 코드

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

응답 예시

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

{
    "content": {
        "disabled": false,
        "id": 1,
        "encodingOptionType": "NORMAL",
        "name": "AVC_SD_1Pass_30fps",
        "format": "MP4",
        "video": {
            "codec": "AVC",
            "codecOptions": {
                "profile": "MAIN",
                "level": "3.1"
            },
            "bitrate": 500,
            "width": 480,
            "height": 320,
            "framerate": -2.0,
            "maxFramerate": 30.0,
            "keyframeInterval": 2.0,
            "rateControl": "ABR",
            "pass": "1-Pass"
        },
        "audio": {
            "codec": "AAC",
            "bitrate": 128,
            "channel": 2,
            "samplingRate": 44100.0
        },
        "defaultSet": true,
        "memberNo": -1
    }
}