인코딩 옵션 정보 조회

Prev Next

VOD Station은 인코딩 옵션의 상세 정보를 조회하기 위한 API를 제공합니다.

요청

GET https://vod-station.apigw.gov-ntruss.com/api/v2/encoding-option/{encodingOptionId}

요청 헤더

헤더명 설명
x-ncp-apigw-timestamp 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 표현
API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
x-ncp-apigw-timestamp:{Timestamp}
x-ncp-iam-access-key 네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값
x-ncp-iam-access-key:{Sub Account Access Key}
x-ncp-apigw-signature-v2 Access Key ID 값과 Secret Key로 암호화한 서명
x-ncp-apigw-signature-v2:{API Gateway Signature}

응답

필드명 타입 설명 비고
error Object 요청 실패 시 응답
오류 응답 코드 및 메시지
error.code Integer 오류 응답 코드
error.message String 오류 응답 메시지
content Object VOD Station OPEN API 응답 객체
content.disabled Boolean subaccount 제공 필드
해당 리소스가 subaccount에서 활성 여부
content.id String 인코딩 옵션 ID
content.name String 인코딩 옵션의 이름
content.format String 변환된 미디어 파일 컨테이너 포맷
content.encodingOptionType String 인코딩 옵션의 타입
content.audio Object 트랜스코딩 오디오 옵션 설정 객체
content.audio.codec String 오디오 코덱 설정
content.audio.channel Integer 출력 오디오의 채널 설정
content.audio.bitrate Integer 트랜스코딩할 오디오 스트림의 비트 전송률 설정 (단위 : Kbps)
content.audio.samplingRate Integer 출력 오디오 샘플링 레이트 (단위 : Hz)
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 초당 프레임 수
content.video.keyframeInterval Integer 비디오에 키 프레임이 생성되는 간격 (단위 : 초)
content.video.rateControl String 비트레이트 배분 방식
content.defaultSet Boolean 시스템 제공 프리셋 여부

예시

요청 예시

GET https://vod-station.apigw.gov-ntruss.com/api/v2/encoding-option/10058

GET /api/v2/encoding-option/10058
HOST: vod-station.apigw.gov-ntruss.com
x-ncp-apigw-timestamp:1521787414578
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=

응답 예시

HTTP/1.1 200 OK
Server: nginx
Date: Wed, 12 Sep 2018 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{
  "content": {
    "disabled": false,
    "id": 10058,
    "encodingOptionType": "NORMAL",
    "name": "basic-enc-option",
    "format": "MP4",
    "video": {
      "codec": "AVC",
      "codecOptions": {
        "profile": "MAIN",
        "level": "3.1"
      },
      "bitrate": 5000,
      "width": 1920,
      "height": 1080,
      "framerate": 30,
      "maxFramerate": 30,
      "keyframeInterval": 2,
      "rateControl": "ABR",
      "pass": "1-Pass"
    },
    "audio": {
      "codec": "AAC",
      "bitrate": 192,
      "channel": 2,
      "samplingRate": 44100
    }
  }
}